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PREFACE 


The RT-11 (Real Time-11) computer system is a single-user 
computer/operating system that serves the programming needs 
of both the beginning and the advanced programmer. RT-11 
supports a number of programming languages, including in¬ 
dustry-standard FORTRAN and BASIC: and — for more ad¬ 
vanced users — the PDP-11 assembly language, MACRO-11. 
RT-11 also provides a comprehensive set of operating com¬ 
mands for controlling system operations. 


The purpose of this introductory manual is to acquaint you with 
a number of RT-11 operating commands that are used to per¬ 
form common system operations. The manual first presents in¬ 
formation that you need to understand a particular system op¬ 
eration; then it shows you how to apply the system operation in 
a series of operating commands and exercises that you re¬ 
create; finally, it provides a list of reference materials that con¬ 
tain more information about the operation. This approach 
makes it possible for you to learn quickly the major features of 
the system; at the same time, it eliminates many of the 
learning problems encountered by new users. 

This manual describes system usage fundamentals. It is not the 
intent of this manual to teach you to program the PDP-11 com¬ 
puter. You may already be proficient in one or more of the 
available programming languages. Likewise, no attempt has 
been made in this manual to cover all the possible applications 
for which the RT-11 computer system is suited. You will dis¬ 
cover many applications yourself as you continue to use the 
system. 


This manual is designed for three categories of RT-11 users: 

• Inexperienced users: Those having little or no previous 
"hands-on” computer experience (including those whose expe¬ 
rience has been limited to batch environments) 

• Experienced users: Those who are experienced users of a 
computer system other than the RT-11 computer system 

• Experienced RT-11 users: Those who have used previous 
versions of the RT-11 computer system but wish a quick in¬ 
troduction to the newest features of the current system (Ver¬ 
sion 5) 

The manual contains 17 chapters and 2 appendixes. The de¬ 
scriptions that follow and the chart at the end of this section 
will help you determine your own reading path. 


MANUAL INTENT 


MANUAL DESIGN 








Chapter 1, Introducing the RT-11 Computer System, discusses 
general system concepts. It introduces the roles of hardware 
and software in a computer system and describes the specific 
hardware and software components of the RT-11 computer 
system. Chapter 1 is intended for users in the first two catego¬ 
ries. 

Chapter 2, Starting the RT-11 Computer System, shows all 
users how to start the system. 

Chapter 3, Interacting with the RT-11 Computer System, dem¬ 
onstrates how you use the console terminal to control system 
operations. Again, this chapter is most helpful to users in the 
first two categories. 

Chapters 4 through 7 describe system operations that are 
useful to all categories of users. Each chapter begins with a 
textual explanation of a particular system operation and ex¬ 
pands into computer demonstrations showing the operation in 
use. Topics covered are: Using the Monitor Command Lan¬ 
guage; Creating and Editing Text Files; Comparing Text Files; 
and Performing File Maintenance Operations. Experienced 
RT-11 users may prefer to skip the textual explanations and 
review only the computer exercises. 

Chapter 8, Choosing a Programming Language, helps you 
determine which language to use. Choose BASIC—11, 
FORTRAN IV, MACRO-11, or a combination of these three 
languages to continue the exercises in this manual (BASIC—11 
and FORTRAN IV are optional products)!, 

Chapters 9, 10, and 11 describe the process of running pro¬ 
grams written in the FORTRAN IV, BASIC—11, and 
MACRO^ll languages, respectively. You should read any 
chapters that apply to your choice of language. 

MACRO-11 and FORTRAN IV users should continue to 
Chapter 12, Linking Object Programs, and Chapter 13, Con¬ 
structing Library Files. 

Chapter 14, Debugging a User Program, provides some sugges¬ 
tions for finding and fixing errors in user programs; all users 
should read this chapter. 

Chapter 15, Using the Foreground/Background Monitor, is in¬ 
tended for users who plan to exercise the foreground/back¬ 
ground capability of the RT—11 system. 

All users should continue to Chapter 16, Using Indirect Files. 
Indirect files allow the system to perform operations unat¬ 
tended. 
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Chapter 17 gives some advice to new users and includes a de¬ 
scription of the RT-11 HELP file. 

Two appendixes are provided for reference. Appendix A 
discusses manual bootstrapping procedures and Appendix B 
provides some additional information on selected system usage. 

A glossary of technical terms appears at the end of the manual 
for reference purposes. 

The following flowchart will help you plan your reading path 
through the manual. Read the chart from top to bottom; answer 
the questions and follow the direction of the arrows to see 
which chapters you should read. 

NOTE 

The demonstration portions of this manuai are for use 
with Version 5 and later reieases of RT-11. The exer¬ 
cises are quite lengthy, and you may prefer not to com¬ 
plete them in one sitting. You may pause at the end of 
any individual chapter. It is recommended that you stop 
only at the end of a chapter since you will otherwise not 
complete an exercise and thus may introduce errors that 
will affect later exercises. Instructions for pausing and 
beginning again are given in Appendix B. 


c 
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Figure 1 Flowchart for Selective Reading 


















































CHAPTER 1 

INTRODUCING THE RT-11 COMPUTER SYSTEM 


A computer system is a collection of components that work to¬ 
gether to process data. The purpose of a computer system is to 
make it as easy as possible for you to use a computer to solve 
problems. A functioning computer system combines hardware 
elements with software elements. The hardware elements are 
the mechanical devices in the system, the machinery and the 
electronics that perform physical functions. The software ele¬ 
ments are the programs written for the system; these programs 
perform logical and mathematical operations and provide a 
means for you to control the system. Documentation includes 
the manuals and listings that tell you how to use the hardware 
and software. Collectively, these components provide a com¬ 
plete computer system that allows both layman and expert 
alike to use a computer. ‘ 

SYSTEM HARDWARE 
SYSTEM SOFTWARE 
-h SYSTEM DOCUMENTATION 

COMPUTER SYSTEM 

The RT-11 computer system requires three basic hardware 
items: the computer, which performs all data processing; a ter¬ 
minal device, used like a tjT)ewriter for two-way communica¬ 
tion between the user and the system; and a storage medium, 
for storing programs and data. Figure 1-1 illustrates the hard¬ 
ware components of a typical RT-11 computer system. 


The computer performs all instruction decoding and data pro¬ 
cessing. The RT-11 computer system is constructed around a 
DIGITAL PDP-11 computer, several of which are shown in 
Figure 1-2. Any model of PDP-11 can be used in an RT-11 
system. 

Notice in Figure 1-2 that the front panel, or operator’s console, 
of each PDP-11 computer is slightly different. The switches, 
buttons, and lights that are on the operator’s console are used 
for various kinds of computer operations and applications. In 
the RT-11 computer system they are used only to start the 
system. Once the system has been started, your interaction 
with the computer system occurs through the terminal. 

'This chapter attempts to build a working vocabulary that is both meaningful 
to the new user and consistent with standard DIGITAL terminology. Some 
definitions may appear inconsistent with those you have previously learned 
or used. 


SYSTEM 

HARDWARE 


The Computer 
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Figure 1-1 RT-11 Computer System 
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Figure 1-2 PDP-11 Computers 


The terminal allows two-way communication between you (the 
user) and the computer system. You enter information — opera¬ 
ting commands, for example — from the terminal keyboard, 
which is operated much like a typewriter keyboard. The com¬ 
puter, in turn, prints information and messages on the ter¬ 
minal’s printer or screen. Figure 1-3 shows two terminal 
devices — the VTIOO video terminal and the IjA 120 hardcopy 
terminal — that can be used in an RT-11 computer system. 


The Terminal 
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Figure 1-3 Terminal Devices 



Generally, an RT-11 computer system has only one terminal 
through which all system/user interaction takes place. This is 
called the console terminal. If the system has more than one 
terminal, one of them is still designated the console terminal; 
others simply provide auxiliary message-printing capabilities. 


The Storage 
Medium 


The third important hardware device in an RT-11 computer 
system is the storage medium (usually a disk). It stores pro¬ 
grams — those that make up the computer system software and 
those that you create. It serves as a distribution medium; 
system software is often packaged and distributed on a disk by 
the system supplier. Finally, it stores other data, information 
that is eventually needed for a computer operation (called 
input), the results of a computer operation (called output), or 
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textual information such as a report. Figure 1—4 shows the 
random-access storage media (and their specific drive units) 
that can be used in an RT-11 computer system. (Random access 
means that access time for data is independent of the location of 
data. Contrast this concept with sequential access.) 


JD 



Figure 1-4 Random-Access Storage Media 
and Their Devices 
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Optional Devices 


These three devices — the computer, the terminal, and the 
storage medium — are the required hardware components of an 
RT-11 computer system. With the exception of the computer, 
all hardware devices are called peripheral devices. Peripheral 
devices supplement the computer by providing external re¬ 
sources for operations that the computer cannot handle alone. 
In addition to the terminal and storage medium (which are re¬ 
quired peripheral devices), other peripheral devices can be used 
in an RT-11 computer system. 


Optional peripheral devices are added to a computer system 
according to the specific needs of the system users. For ex¬ 
ample, computer systems that are used primarily for program 
development may have extra storage devices and a high-speed 
printing device. Computer systems used in a laboratory envi¬ 
ronment may have graphics display hardware, an oscilloscope 
device, and an analog-to-digital converter. Computer systems 
that provide (or use) information in conjunction with another 
kind of computer system usually have a magtape device, be¬ 
cause magtape is an industry-standard storage device. 

Peripheral devices are categorized as input/output (I/O) devices 
since the functions they perform provide information (input) to 
the computer, accept information (output) from the computer, 
or do both. Line printers are output devices because they per¬ 
form only output operations. Terminals and storage devices are 
input/output devices because they perform both input and 
output operations. Figure 1-5 shows several of the optional pe¬ 
ripheral devices that are often added to an RT-11 computer 
system. 



Figure 1-5 Peripheral Devices 
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Figure 1-5 Peripheral Devices (Cont.) 

The hardware configuration of your own RT—11 computer 
system includes the computer, the terminal, the storage me¬ 
dium, and any other peripheral devices you choose to add. 


System software is an organized set of supplied programs that 
effectively transform the system hardware components into us¬ 
able tools. These programs include operations, functions, and 
routines that make it easier for you to use the hardware to 
solve problems and produce results. For example, some system 
programs store and retrieve data among the various peripheral 
devices. Others perform difficult or lengthy mathematical cal¬ 
culations. Some programs allow you to create, edit, and process 
application programs of your own. Still others handle entire 
applications for you. 

As illustrated in Figure 1-6, system software always includes 
an operating system, which is the "intelligence” of the com¬ 
puter system. Usually the system software includes one or sev¬ 
eral language processors; it sometimes also includes specific ap¬ 
plications. 


SYSTEM 

SOFTWARE 
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The RT-11 
Operating System 


f 



Figure 1-6 System Software 


An operating system is a collection of programs that provides 
an environment in which you can create and run programs of 
your own. The operating system organizes all the hardware and 
software resources of the computer system into a working unit 
and gives you control. 

The RT-11 operating system comprises four types of programs: 
a monitor/executive program for system control and supervi¬ 
sion; several device handlers (programs), one for each of the 
supported hardware devices; a variety of utility programs for 
program/data creation and manipulation; and finally, the inter¬ 
faces that are necessary to support several programming lan¬ 
guage processors. The operating system is illustrated in Figure 
1-7. 

The monitor (executive) program is the link between the 
system hardware, the system software, and you. Part of the 
monitor function is to accept, process, and execute yoiu* instruc¬ 
tions for controlling the system. A comprehensive set of monitor 
operating commands allows you to direct, from the console ter¬ 
minal keyboard, those system operations that you want to 
occur. 

Device handlers are routines that provide the interface to the 
various hardware devices that are part of the computer system. 
A handler exists for every peripheral device that the system 
supports. 

Utility programs cover a wide range of resources; such pro¬ 
grams allow you to create and edit text, maintain other pro- 
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Figure 1-7 The RT-11 Operating System 

grams, and locate user-programming errors. Some utility pro¬ 
grams in the RT-11 operating system are the following: 

• An editor, which allows you to create and modify textual ma¬ 
terial; this material could be the statements that make up a 
computer program, a memo, or any text you wish to create 

• File maintenance utility programs, which allow you to manip¬ 
ulate and maintain your programs and data — to transfer 
them between devices, to update them, and to delete them 
when you are done with them 

• A debugging program, which helps you uncover and correct 
errors in your programs 

• A librarian, which makes it easy for you to store and retrieve 
often-used programming routines 

• A linking program, which converts object modules into a 
format suitable for loading and execution 

• A source comparison program, which is used to compare two 
ASCII files and to output any differences to a specified output 
device 

• A dump program, which outputs to the console or line printer 
all or any part of a file in octal words, octal bytes, ASCII 
characters, or Radix-50 characters 

The RT-11 operating system also provides support for several 

programming languages and their respective language proces¬ 
sors. 
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Language 

Processors 

A language processor is a translating program that you use to 
process a source program you have created. A language pro¬ 
cessor exists for every programming language supported by the 
system, whether it is a high-level language or a machine-level 
language.* 

High-level languages, such as BASIC—11 and FORTRAN IV, 
are relatively easy languages to learn and use. Since a single 
language statement often performs a series of intricate com¬ 
puter operations, high-level languages let you direct your at¬ 
tention to solving the problem at hand. They do not require 
that you understand how the computer interprets the problem. 
In addition to FORTRAN IV and BASIC-11, the RT-11 opera¬ 
ting system supports the high-level language DIBOL, DIG¬ 
ITAL’S interactive commercial language. 

Machine-level or assembly languages are available for users 
who prefer to work at the instruction level of the computer. At 
this level, you have control over such factors as program size 
and speed of execution. Machine-level languages do require 
that you be familiar with the computer and the hardware de¬ 
vices of the system. RT-11 provides the MACRO-11 assembly 
language processor for those who would rather work at this 
more intricate level. 

Applications 

Packages 

The RT-11 operating system supports several applications 
packages. These include a laboratory applications package for 
the standard functions found in most laboratory environments. 
A scientific subroutine package (for FORTRAN IV users) pro¬ 
vides a large selection of mathematical and statistical routines 
commonly required in scientific programming. And a graphics 
support package for BASIC-11 and FORTRAN IV users pro¬ 
vides display features such as multiple intensity and blinking 
vectors (lines), alphanumerics, and points. Because of the spe¬ 
cialized nature of these applications packages, they are not de¬ 
scribed further in this manual. 

SYSTEM 

DOCUMENTATION 

The third component of a computer system is documentation, 
which includes manuals that tell you how to use the software 
and hardware of the computer system. Documentation also in¬ 
cludes any source listings of programs that make up the opera¬ 
ting system. 

Hardware Manuals 

Hardware manuals describe the devices in the computer 
system. RT-11 hardware documentation includes a Processor 

^Language selection is discussed in Chapter 8 of this manual. 
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Handbook that describes the PDP-11 computer you are using, 
and a User’s Guide or Maintenance Manual for each peripheral 
device in your computer system. These manuals tell you how to 
operate the devices and give you special programming informa¬ 
tion that you may need if you intend to write device drivers or 
special system software involving the devices. 


Software manuals* describe the operating system and the lan¬ 
guage processors. RT-11 software documentation falls into 
three major categories: introductory or once-only manuals (in¬ 
tended to be used once and then stored away); console manuals 
(intended to be used at the computer); and desk/console man¬ 
uals (intended to be used at your desk for reference purposes). 

Once-only manuals include this manual and others that are 
needed only when your system is initially installed. You may 
have little or no occasion to use these manuals once your com¬ 
puter system is in operation and you are familiar with its use. 

Console manuals are those manuals that tell you how to use the 
computer system. They describe in detail command usage and 
syntax, list summaries of system operations, and give the 
meanings of system messages. The RT—11 System User’s Guide 
is an example of a console manual. 

Desk/console manuals are those manuals that you continually 
use for reference as you write your own application programs. 
These manuals include the general language reference man¬ 
uals and the advanced programming manuals that contain pro¬ 
gramming information specific to the RT—11 computer system. 
The RT-11 Software Support Manual is an example of a 
desk/console manual. 


Source listings are actual listings of the assembly language 
code that makes up the RT-11 operating system. These listings 
are very detailed and are generally needed only if you intend to 
modify the system software. They can be ordered on microfiche 
from the DIGITAL Software Distribution Center. 

This completes a general introduction to the RT-11 computer 
system. Subsequent chapters of this manual describe how you 
use the various system components mentioned here to perform 
a series of related computer operations. You begin in Chapter 2 
by learning how to start the RT-11 computer system. 


*A11 RT—ll-related software manuals are listed and described in the Guide to 
RT-11 Documentation. Many of these manuals are provided with your sys¬ 
tem; others can be ordered from the DIGITAL Software Distribution Center. 


Software Manuals 


Source Listings 
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CHAPTER 2 

STARTING THE RT-11 COMPUTER SYSTEM 


Before you can use the RT-11 computer system to perform any 
operations, you must start it. Starting the system involves 
turning on the computer and the various hardware devices and 
loading the appropriate software components into computer 
memory. 


Within every PDP-11 computer is a physical, designated 
storage area called memory. Computer memory is where 
system information and data are temporarily loaded and stored 
for use during the various system operations. 

Each time you use the computer system, there may already be 
information in computer memory, left by the person who used 
the system last. For example, there may be the results or data 
of another user’s program; there may be the results of a partic¬ 
ular system operation; there may even be an entirely different 
operating system in memory. For your purposes, computer 
memory must contain the RT-11 operating system, and specifi¬ 
cally the RT-11 monitor program. Thus, your first operation as 
a system user is to transfer the monitor program from the disk 
device, where it was stored during system installation, to com¬ 
puter memory, where you can use it. The process of transferring 
the RT-11 monitor to memory is called bootstrapping the 
system; it is the only system operation that requires you to use 
the operator’s console on the front panel of the computer (see 
Figure 2-1). 


Starting the RT-11 computer system requires that you know 
how to operate your system’s hardware devices. Since you may 
not have had the opportunity to use any of the devices yet, ask 
an experienced user to help you the first time. Follow the in¬ 
structions in the section in this chapter entitled "Bootstrap Pro¬ 
cedure.” If necessary, refer to the RT-11 Automatic Installation 
Booklet, the RT-11 Installation Guide, or the various hardware 
manuals provided with your system. 

First read through the following material and fill in the appro¬ 
priate information where requested. You should be able to 
determine all responses by checking the RT—11 Automatic In¬ 
stallation Booklet or the RT-11 Installation Guide. 


COMPUTER 

MEMORY 


HARDWARE 

CONFIGURATION 
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Figure 2-1 Bootstrap/Computer Relationship 


NOTE 

If your system device is a diskette, you need to build four 
volumes and, when running some of the demonstration 
programs, limit the volumes to the components needed 
to execute the programs. Also, you need to preserve the 
distribution volume you received from DIGITAL by 
making backup copies. The RT-11 automatic installation 
procedure performs these functions for you. If you did 
not use the automatic installation procedure to install 
your RT-11 system, the RT-11 Installation Guide will 
provide you with the commands you need to copy and 
preserve the distribution volume and create the volumes 
for use with this manual. 


You must have the following materials to start the system and 
to perform the exercises in this manual: 


• The volume containing the RT-11 operating system (called 
the system volume); refer to Section 2.3.6 of the RT-11 Instal¬ 
lation Guide for the list of components you will need on your 
system volume to perform the exercises 


• The volume containing the FORTRAN IV and/or BASIC-11 
language processors if these languages are not stored on the 
system volume (available only to FORTRAN IV and 
BASIC-11 users) 
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• A volume for program storage (for example, magtape or an¬ 
other disk or diskette); this volume should contain no im¬ 
portant information since all information on it will be erased 
during a later computer exercise 

• A copy of the RT-11 Automatic Installation Booklet or the 
RT-11 Installation Guide 


NOTE 

You can find hardware configuration information in the 
various hardware manuais provided with your system. 
Instructions for starting (bootstrapping) your RT-11 
system appear in the RT-11 Automatic Installation 
Booklet and the RT-11 Installation Guide. This informa¬ 
tion should be adequate for you to answer all the ques¬ 
tions asked here. If you have trouble, see Appendix B, 
Suggestions for Bootstrapping the System. Do not con¬ 
tinue to any other chapter in this manual until you under¬ 
stand the following configuration information and can 
bootstrap the system yourself. 


1. What kind of terminal device are you using (for example, 
LA120 DECwriter III, VTIOO video terminal)? 


2. Is your computer a PDP-11/23-PLUS, PDP-11/24, or 
PDP-11/44? 

3. Does your computer operator’s console have pushbuttons or 
switches? 

4. How much memory does your computer have? 


5. What kind of system volume are you using (for example, 
RL02 disk, RX02 diskette)? 

6. What is the two-letter mnemonic for this volume (typical 
mnemonics are given in Table 2-1; respond with the mne¬ 
monic for your own volume)? 


Terminal 


Computer 


System Volume 
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Storage Volume 


Optional Devices 
and Supported 
Languages 


BOOTSTRAP 

PROCEDURE 


Table 2-1 Representative System Volumes 


Volume 

Mnemonic 

RXOl Diskette 

DX 

RX02 Diskette 

DY 

RK05 Disk 

RK* 

RK06/07 Disk 

DM 

RC25/RD51 Disk, RX50 Diskette 

DU 

RLOl/02 Disk 

DL 


* Use DK to bootstrap from an RK05 disk. 


7. What volume are you using for program storage (for ex¬ 
ample, TSll magtape, RL02 disk)? 

8. In which device unit will you use this volume (choose any 
available device unit — for example, 0, 1)? 


9. W^hat peripheral devices are part of your system (for ex¬ 
ample, line printer, magtape, VTll display hardware; list 
all devices other than the terminal and the computer)? 

10. What programming languages does your system support 
(MACRO-11 or BASIC-11, for example)? 


Once you have determined your hardware configuration, you 
are ready to bootstrap the system. The purpose of the bootstrap 
procedure is to load and start the RT-11 monitor in computer 
memory, thus activating the RT-11 computer system for your 
use. 


NOTE 

If your answer to question 2 in the Hardware Configura¬ 
tion section is YES, continue to the next paragraph. Oth¬ 
erwise, read the section entitled Bootstrapping the 
System, in Appendix A, for bootstrap instructions. 

The bootstrapping procedure for the RT-11 computer system on 
a PDF-11/23—PLUS, PDP-11/24, or PDP—11/44 processor con¬ 
sists of the following steps. For more detailed instructions on 
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o 

c 

o 



the bootstrap operation, refer to the RT-11 Automatic Installa¬ 
tion Booklet. 

1. Turn the terminal to an on-line condition. 

2. Make sure that the computer power is on and that the com¬ 
puter is not already in use. 

• If your computer is a PDP-11/23-PLUS, power up the 
system by lifting the AUX toggle switch to the ON posi¬ 
tion. The red PWR OK indicator on the front panel will 
light up if the system was successfully turned on. 

• If yoiu* computer is a PDP-11/24 or a PDP-11/44, power 
up the system by turning the status selector key to the 
LOCAL position. The red DC ON indicator on the front 
panel will light up if the system was successfully turned 
on. 

3. Stop the computer. 

• If your computer is a PDP-11/23-PLUS, lift the HALT 
toggle switch to the up position. The AUX toggle switch 
that you lifted in the previous step and the HALT toggle 
switch can be lifted simultaneously. 

• If your computer is a PDP-11/24 or a PDP-11/44, push 
the HALT/CONT/BOOT horizontal toggle switch to the 
HALT position. 

4. Load the system volume in its corresponding device unit 0. 
Make sure that the system volume is write-protected (for all 
except RXOl or RX02 diskettes, which are always write- 
enabled). 

5. Load the storage volume in the device unit noted in ques¬ 
tion 8 in the Hardware Configuration section. Make sure 
that this volume is write-enabled. 

6. Boot the system. 

• If your computer is a PDP-11/23-PLUS, lift the RE¬ 
START toggle switch on the front control panel. This 
switch will not remain in the up position; it will spring 
back to the center position. 

• If your computer is a PDP-11/24 or a PDP-11/44, push 
the HALT/CONT/BOOT horizontal toggle switch to the 
BOOT position. This switch will not remain in the right¬ 
most position; it will spring back to the center position. 

The red RUN indicator on the front control panel should 
now be illuminated. 
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A series of self-diagnostic routines to check out the system are 
then executed. The execution of these routines may take up to a 
minute, depending upon how much memory is installed in your 
system. A prompt appears on your console terminal when exe¬ 
cution of the routines is completed. The prompt that appears is 
dependent upon the type of processor you are using. Table 2-2 
provides the prompts that appear and the corresponding re¬ 
sponses which must be supplied if you are using the 
PDP-11/23-PLUS, PDP-11/24, or PDP-11/44 processor. 


Table 2-2 Bootstrap Prompts and Responses 

Processor 

Prompt 

Response 

PDP-11/23- 

-PLUS TESTING MEMORY 
wwww.KW 

START? 

dd[n]® 

PDP-11/24 

bbbbbbbb 

<none> 

PDP-11/44 

»> 

B dd[n]® 

wwww. 

bbbbbbbb. 

dd[n] 

= amount of memory in K-words (decimal) 

= amount of memory in K-bytes (octal) 

= device mnemonic (dd) and unit number (n) 


7. Respond to the prompt that appears on your console ter¬ 
minal by typing the appropriate response (refer to Table 
2-2) followed by a carriage return. 

NOTE 

Refer to question 6 in the Hardware Configuration sec¬ 
tion for the two-letter device mnemonic (dd) and refer to 
question 8 for the device unit number (n). 

You should now direct your attention to the console terminal, 
since system interaction continues on this device. 
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guage instruction set. 
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CHAPTER 3 

INTERACTING WITH THE RT-11 COMPUTER SYSTEM 


Interaction with the RT-11 computer system involves an ex¬ 
change of information between you (the user) and the software 
operating system. The exchange may be active, with you dic¬ 
tating command information from the terminal keyboard and 
the system responding immediately; or it may involve the 
storing of information on mass storage volumes for later use. 


During the bootstrap procedure you activated the RT-11 com¬ 
puter system by loading and starting the monitor program in 
computer memory. One of the functions of the monitor program 
is to provide you with the capability to use the console ter¬ 
minal. Since the console terminal can perform both input and 
output operations, it is used to interface between the system 
and the user. With it, you can: 

• Type the commands that control system operation 

• Receive messages and responses from the system 

All console terminals have a keyboard — used to enter informa¬ 
tion — and a paper output device or video screen — used to echo 
characters typed at the keyboard and to print system messages 
and responses. Figure 3-1 shows two commonly used terminals, 
the LA120 and the VTIOO. 

These two terminals differ in their output mechanism. While 
the LA120 terminal has a paper printer, the VTIOO has a video 
screen. The paper printer and the screen serve the same pur¬ 
pose — they show user input and system responses; however, 
paper output can be saved for later use .while screen output is 
temporary. The keyboards of both terminals are shown in Fig¬ 
ure 3-2. 


USING THE 
CONSOLE 
TERMINAL TO 
EXCHANGE 
INFORMATION 
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LA120 



VTIOO 

Figure 3-1 LA120/VT100 Terminals 





3-2 





Interacting with the RT-11 Computer System 



LA120 



VTIOO 

Figure 3-2 LA120A^T100 Keyboard Layouts 


Using Figure 3-2 as a guide, study your own terminal key¬ 
board. First, notice that the keys for the alphabetic characters 
are positioned in the same way as on most standard typewrit¬ 
ers. The SHIFT key allows you to select between numeric and 
special characters and between uppercase and lowercase 
characters.^ The position of the numeric and special characters 
varies somewhat among the different terminals, so you may 
need to hunt for a particular key until you become familiar 
with your own terminal. 

Locate the DELETE key. This key is used to correct a typing 
mistake. Pressing the key once cancels the last character typed. 
Pressing it twice cancels the last two characters, and so on, 
back to the beginning of the line. 


'With the exception of system messages and one other exception explained in 
Chapter 5, the RT-11 computer system uses uppercase characters exclusively. 
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USING 

MASS STORAGE 
VOLUMES 


Locate the TAB key. Tab stops on a computer terminal are 
positioned every eight spaces across the line, beginning at 
column 1. Pressing the TAB key moves the character pointer 
(that is, the position on the line where the next character will 
be typed) to the beginning of the next tab stop. 

The key marked RETURN performs a carriage return; it both 
returns the character pointer to the beginning of the line and 
advances it to the next line. This key is used to terminate the 
line currently being typed and to terminate certain RT-11 
system commands. 

Locate the ESC key and the LINE FEED key. These are special 
command terminators that are described in Chapters 5 and 14. 

An important key is the CTRL key. It is always used with an¬ 
other character key to perform one of several system opera¬ 
tions. CTRL commands are explained in detail when you begin 
to use them later in the manual. 

Table 3-1 reviews the console terminal keyboard characters. 
Keys not mentioned are not used by the RT-11 computer 
system and can be ignored. 

You will have an opportimity to become familiar with your ter¬ 
minal keyboard as you perform the demonstrations in this 
manual. 

The console terminal also displays messages and responses 
from the system. These messages and responses provide or re¬ 
quest information. Error messages are an example of informa¬ 
tional output; they help you detect typing errors, progr ammin g 
errors, and system malfunctions. If an error message appears 
on your console terminal while you are performing the demon¬ 
strations in this manual, refer to the RT-11 System Message 
Manual for an explanation of the cause of the message and a 
description of the corrective action that should be taken. 


Mass storage volumes provide an area (apart from computer 
memory) to keep information for later use. The information 
may be user application programs, data needed by a program, 
the results of a program run, textual information, batch-type 
programs, and so on. As an example, the RT-11 operating 
system is stored on a mass storage volume called the system 
volume. When information is needed, as it was during 
bootstrapping, information from the storage volume is trans¬ 
ferred into computer memory. 


3-4 





Interacting with the RT-11 Computer System 


Before you can access the information stored on a storage 
volume, however, you must first insert the volume (the me¬ 
dium) into its corresponding device unit (drive), the hardware 
device connected to the computer. Once a volume has been in¬ 
serted into a device unit, the device unit’s symbol identifies the 
volume. There may be more than one device unit for a volume, 
each individual device unit is numbered 0, 1, 2, and so on. As 
you learned in the bootstrap procedure, the system volume is 
inserted in device unit 0 and remains in it as long as you are 
using the system. Other storage volumes can be inserted in any 
available device units. Figure 3-3 illustrates several mass 
storage volumes. 


Table 3-1 Keyboard Characters 


Key 

Function 

BACK SPACE 

Ignored during normal system use 

BREAK 

Ignored during normal system use 

CTRL 

Control; part of several two-key command 
combinations that perform specific system 
functions 

DELETE 

Erase; cancels the last character typed 

ESC 

Command terminator; terminates an editing 
command string; transmits the command to 
the computer and performs a carriage return 

LINE FEED 

Command terminator; terminates certain 
system commands; transmits the command to 
the computer and performs a carriage return 

REPEAT 

Ignored during normal system use 

RETURN 

Line terminator, command terminator; termi¬ 
nates the current line; terminates certain 
system commands; transmits the command to 
the computer and performs a carriage return 

SHIFT 

Selects the uppermost of two characters ap¬ 
pearing on a key 

TAB 

Moves the character pointer ahead to the be¬ 
ginning of the next tab stop 

any other 
key 

Transmits the alphanumeric or special char¬ 
acter to the computer 
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Mass storage volumes hold large amounts of information. Most 
volumes, however, are physically small enough so that you can 
transport them from the system, to your desk perhaps, or to 
another computer system. In addition to disks (shown earlier in 
Figure 1-4), magtapes are also mass storage volumes. 


You store information on a mass storage volume in the form of 
files. Each file is a logical collection of data. Files may be parts 
of programs or entire programs, program input data, or text, 
such as a letter or report. Whatever its content, each file is 
treated as a unit and occupies a fixed area of the volume. 

Every file on a mass storage volume has a unique name that is 
composed of a file name and a file type. The file name and file 
type identify the file and distinguish it from other files on the 
volume. You can instruct the system to print on your terminal 
the names of all files on a volume. The resulting list is called 
the volume directory listing. By referring to the volume direc¬ 
tory, you can find the name, size, and creation date of each file 
on that volume and delete old files that you no longer need. 
Whenever you perform an operation that affects the contents of 
the volume, a new volume directory reflects the change. 


Occasionally, after many files are added to a storage volume, 
the volume has no room for new information. A storage volume 
may also become damaged, lost, stolen, or worn through use. 
For these reasons it is a good idea to have several extra storage 
volumes on hand and to protect your more important files 
against accidental erasure or loss. 

One way to protect a file is to make a copy of it on a second 
storage volume. The copy, called a backup file, insures you 
against the loss or damage of your original file (or its respective 
storage volume). 

Some storage volumes provide a mechanism that protects files 
against accidental erasure. This mechanism is generally a 
switch on the volume itself, or on the device unit, that you can 
set to a write-protect or write-enable condition (as you did 
during bootstrapping). When the volume is write-protected, in¬ 
formation can be copied only from the volume to computer 
memory or to another volume that is write-enabled. A volume 
that is write-enabled, on the other hand, also allows informa¬ 
tion to be copied from memory back to the volume. 


File Storage 


File Protection 
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REFERENCES 


The RT-11 operating system itself provides a protection fea¬ 
ture. This optional feature requires that you confirm certain 
system commands that might otherwise erase important infor¬ 
mation. The system also issues prompting messages so that you 
provide the proper file information when it is needed by a com¬ 
mand. 

Chapter 4 and succeeding chapters require you to use the ter¬ 
minal to enter command information and perform file copy and 
other system operations. Before you continue, make sure that 
there is a backup copy of your system volume. If you cannot 
locate one, read Appendix B, Backing Up the System Volume, 
before going on. 


RT-11 System Message Manual (AA-5284I>-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

An explanation of system messages that may occur during normal 
system use; includes required user actions. 

VTIOO User Guide (EK-VT100-UG^002). Maynard, Mass.; Digital Equip¬ 
ment Corporation, 1978. 

A manual for the owners and operators of the VTIOO video terminal and 
for those who will be programming computers to interact with these 
devices. 
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CHAPTER 4 

USING THE MONITOR COMMAND LANGUAGE 


Dviring the bootstrap operation, the RT-11 monitor was copied 
into computer memory and started. The RT—11 monitor is actu¬ 
ally many different components working together to supply 
basic system functions. For example, the part of the monitor 
called the resident monitor (RMON) provides the console ter¬ 
minal service and central program code necessary for a working 
environment for both system and user programs. The resident 
monitor is so named because it always remains in computer 
memory, regardless of other system operations that may be oc¬ 
curring. Other parts of the monitor are brought into memory 
from the system volume as needed. These include the user ser¬ 
vice routine (USR), which provides support for the RT-11 file 
system, and the keyboard monitor (KMON), which controls ter¬ 
minal keyboard interaction. From your standpoint, the key¬ 
board monitor is the most visible part of the system software. 
Among other services, it supplies the monitor command lan¬ 
guage that you use to control system operations. 


The monitor command language is a set of English-like com¬ 
mand words that you type on the terminal keyboard to initiate 
and control system operations. You can type a command in one 
of two general formats: a long format or a short format. The 
long format causes the system to print prompting messages. 
These messages ask you to supply specific information, such as 
file names and device names. The long format is helpful until 
you become familiar with the commands. You will then prob¬ 
ably prefer to use the short format, which allows you to enter 
all required information on a single command line and provides 
prompts only if you do not supply necessary information. Both 
formats are demonstrated throughout this manual. 

You terminate all monitor commands with a carriage return. 
That is, after you type the required command information, you 
press the carriage return key (represented in this manual by 
®). This instructs the monitor to initiate the command and to 
perform the operation. 

A prompt character — a period at the left margin of the ter¬ 
minal printer or screen — appears whenever the RT-11 mon¬ 
itor is waiting for you to t3q)e a command. The period is your 
cue that the system is in the monitor command mode and ready 
to accept a monitor command. Check the output on your ter¬ 
minal printer or screen. You should see the following at the left 
margin: 

RT-llFB 005.XK 


ENTERING 

COMMAND 

INFORMATION 
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RT—IIFB identifies the RT—11 monitor called the 
foreg^ound^ackground (FB) monitor. Following this is the ver¬ 
sion (and update) number of the system in use, in this case, 
Version 5. The period on the next line indicates that the system 
is in the monitor command mode and is waiting for you to type 
a monitor command. 


General Command 
Format 


Whenever you issue a monitor command, you must supply cer¬ 
tain information to guide command processing. This informa¬ 
tion includes the following (square brackets indicate optional 
qualifiers and characters): 


COMMAND[/option] 


INPUT[/option] 


OUTPUT[/option]» 


First you indicate, by command, 
which system operation you want ini¬ 
tiated. Command options are avail¬ 
able to allow you to alter the normal 
(default) operation. 

You next indicate, by device and file 
name, input information that is to be 
used during the operation. The system 
volume serves as the default input de¬ 
vice. You must explicitly indicate 
other volumes that you want used for 
input, and you must usually indicate 
the file names and file t 5 q)es of the 
input files. Input file options are avail¬ 
able to allow you to alter assumed (de¬ 
fault) input operations. 

Finally you indicate, by device and file 
name, output information that is to be 
created as a result of the operation. 
The system volume serves as the de¬ 
fault output device. You must expli¬ 
citly indicate other volumes that you 
want used for output, and you must 
usually indicate the file names and 
file types of the output files to be cre¬ 
ated. Output file options are available 
to allow you to alter assumed (default) 
output operations. 


As mentioned earlier, you can type this command information 
on the terminal keyboard in one of two formats; illustrations of 
both follow: 


‘OUTPUT[/option] is not always used; sometimes output must be specified 
COMMAND[/option] INPUT/OUTPUT:filespec. 
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Long Command Format (system prompts for specific informa¬ 
tion) 

.COMMANDC/option]® 

INPUT PROMPT? INPUTC/option]® 

OUTPUT PROMPT? OUTPUT C / o Pt i o n D® 

Short Command Format (no prompts) 

.COMMANDC/option] I NPUT [ / o p t i on ] OUTPUT C / o Pt i on ]® 

Notice that a slash character (/) separates an option from the 
portion of the command that it qualifies, and a carriage return 
® terminates each individual command line. When you have 
supplied all the necessary information, the carriage return sig¬ 
nals the monitor to execute the command. You can use either 
format; both are demonstrated throughout this manual. 


In addition to monitor commands, RT-11 has several special 
function commands, called control commands, that you type by 
first pressing and holding down the CTRL key on the terminal 
keyboard and then typing the letter key of the command. To 
execute the CTRL/C command, for example, type the letter C 
while holding down the CTRL key. These control commands 
require no terminator; the system performs the function as soon 
as you type the command. 

Control commands are used to interrupt program execution, to 
inhibit terminal output, and to perform other similar special 
system operations. They are described in the manual as you 
need to use them. 


During the course of this chapter, and throughout the re¬ 
mainder of the manual, you will use a number of monitor com¬ 
mands to perform some common system operations. For ex¬ 
ample, you will list the directories of device volumes, copy files 
between devices, create files, and execute system and user pro¬ 
grams. You perform these operations by re-creating on the ter¬ 
minal keyboard the examples already provided for you. 

You should first read the entire explanation of a command to be 
aware of its format, the operation it performs, and the options 
that are available. Then type the command on the terminal 
keyboard exactly as you see it used. Characters that you type 
appear in the demonstrations in red print. Characters that are 
system responses are shown in black print. 

Table 4-1 lists symbols that you will see used throughout the 
demonstrations. These symbols represent various keys on the 


Control Commands 


Re-Creating the 
Examples 
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terminal keyboard. When you see one of these symbols in a 
command line, type the appropriate key on the keyboard. 


Table 4-1 Keyboard Symbols 


Symbol 

Type 

® 

carriage return key 

m 

line feed key 


space bar (once for each time the symbol is shown). 
Assume that you should t 3 q)e a single space unless 
you are otherwise instructed; the space symbol is 
used only if there is doubt about the number of 
spaces to type. 


TAB key (once for each time the symbol is shown) 


DELETE key (once for each time the symbol is 
shown) 


ESCAPE key (once for each time the symbol is 
shown) 

(CTRL/x ) 

CTRL key (hold down CTRL key while typing the 
letter character [x]) 


CORRECTING 

TYPING 

MISTAKES 


CTRL/U 


All commands that you give the system are typed on the ter¬ 
minal keyboard. If you make a mistake while typing a com¬ 
mand, you can correct it in one of two ways. 

One way to correct a typing error is to use the DELETE key on 
the keyboard. Pressing the DELETE key once cancels the char¬ 
acter just typed; pressing it a second time cancels the next to 
last character typed, and so on, from right to left, until the 
beginning of the line is reached. Then additional DELETES are 
ignored. 

The second way to correct a typing error is to use CTRL/U, a 
special control command. Typing this command once is equiva¬ 
lent to typing as many DELETES as are needed to cancel every 
character in the current line. 

T 5 q)e on the keyboard the letters DABE, followed by two DE¬ 
LETES, followed by the letters TE, and notice the system’s re¬ 
sponse: 

. DABE ® ® TE 

The monitor echoes each deleted character and encloses them 
within backslashes. As far as the monitor is concerned, the only 
characters you have tjqjed are DATE. 
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.DABE\EB\TE 

Thus, your current line is DATE. Continue by typing a 
CTRL/U. Remember to first press and hold down the CTRL key 
and then type the U key; no carriage return is necessary. 

(CTRL/U 1 


Notice that CTRL/U echoes on the terminal printer or screen as 
'U. 

.DABE\EB\TE'U 

All characters on the line are canceled, and the character 
pointer is moved to the beginning of a new line so that you can 
enter another command. You are still in the monitor command 
mode even though no prompting period appears at the left 
margin. 

Once the carriage return or line feed key is pressed, the pre¬ 
vious line cannot be corrected with DELETE or CTRL/U. 

These two methods are commonly used to correct typing errors 
made at the keyboard. You can choose whichever method seems 
most convenient. 


The kinds of command operations that you usually perform im¬ 
mediately after the monitor is bootstrapped are those that set 
up initial conditions, such as the current date and time of day, 
and those that initialize and prepare the system for future oper¬ 
ations such as file transfers. If your system has VTll display 
hardware that you want to use, you should also enable (turn on) 
the graphics display screen. 


Display hardware on an RT-11 computer system consists of a 
cathode ray tube that allows programs to use graphics displays. 
If your system has display hardware* (Figure 4-1), you can use 
the graphics screen in place of the terminal printer or screen. 

NOTE 

Check question 9 in the Hardware Configuration section 
of Chapter 2 to determine if your system has display 
hardware. If you do not have display hardware, go on to 
the next section. Entering the Date and Time-of-Day. 


*Video terminal screens are not considered 


graphics display hardware. 


INITIAL MONITOR 
COMMAND 
OPERATIONS 


Using VT11 Display 
Hardware 
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GT 


The monitor command that enables the graphics screen is the 
GT command. The GT command is used to change the condition 
of the graphics display. In this case, you will use it to activate 
the graphics display hardware so that the VTll display screen 
replaces the console terminal printer or screen as the terminal 
output device. 



Figure 4-1 VTll Display Hardware 

Type the following on your terminal keyboard (if necessary, 
refer to Table 4-1 to review the special symbols): 

Long and Short Command Format 

• GT ON® 

If your system does not have display hardware, the monitor 
prints a message' on the terminal printer or screen informing 
you that the command is invalid for your system configuration: 

7KM0N-F-Inua 1id command 

Otherwise, the command is accepted. You should notice that all 
character-echoing and system responses are now directed to the 
graphics screen instead of to the terminal printer or screen. 
After the command has been accepted, a period appears on the 
graphics screen, indicating that the system is waiting for an¬ 
other command. The character pointer is visible as a blinking 
rectangular cursor situated after the period. (In the edit mode, 
the cursor is L-shaped.) 


'The meanings of all system messages are listed in the RT-11 System Mes¬ 
sage Manual. 
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Like output on the terminal screen, output that appears on the 
graphics screen is temporary. Once the screen is filled, lines are 
rolled ofT the top and are lost to view. However, if your terminal 
has a printer, a special control command allows you to control 
console terminal output so that it appears on both the graphics 
screen and the terminal printer simultaneously. In this 
manner, you can direct selected portions of terminal output — 
directory listings, for example — to be both displayed and 
printed at the same time. The advantage of this is that al¬ 
though the display copy is eventually lost, you have a printed 
copy for later use. 

The control command that provides this function is CTRL/E, 
which is initiated by holding the CTRL key down while typing 
the E key. No carriage return is necessary. When you type this 
command, no characters echo on the graphics screen, but you 
should notice that all subsequent characters (both input and 
output) appear on both the graphics screen and the terminal 
printer. 

Thus, if your terminal has a printer and you wish to use the 
printer in addition to your VTll graphics screen, t 3 q)e once: 

(Remember, this command does not echo.) 

Now type the following and notice where the characters echo: 
WRONG COMMAND l5TRi7in 

To disable the printer at any time so that character echoing 
occurs only on the graphics screen, type another CTRL/E com¬ 
mand: 

CTRL/E 1 


CTRL/E 


Finally, to return terminal output control to the terminal, disa¬ 
bling the graphics screen, use the GT OFF command; this 
changes the terminal device handler back to its original output 
setting: 

Long and Short Command Format 

GT OFF® 

Decide now whether to use the graphics screen for the re¬ 
maining demonstrations. If so, use the GT ON command to en¬ 
able the graphics screen, and remember that the CTRL/E com¬ 
mand is available when you wish to produce simultaneous 
output. 
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Entering the Date 
and Time-of-Day 


DATE 


TIME 


Entering the current date and time-of-day helps in record¬ 
keeping for system operations. Later, you can identify when 
system operations were performed. 

For example, by entering the current date you instruct the 
system to assign this date to all files you create. The date will 
also appear in volume directories and listings produced by the 
various language processors and utility programs. If your 
system has a clock, by specifying the current time-of-day you 
instruct the system to keep track of time based on the time you 
set. The current time is printed on listings when they are pro¬ 
duced, and may also be used to control certain program opera¬ 
tions. 

Enter the date by typing the monitor DATE command with the 
day, month, and year as follows (there is only one format): 

Long and Short Command Format 

• DATE 8-JAN-83® 

This sets the date to January 8, 1983. Since this date is not 
current, reenter the correct date using the same command 
format: 

• DATE dd-wntm-yy® 

Typing the new date overrides the previous date. 

The date that is set is temporary. You must reenter it whenever 
you bootstrap the system. 

The monitor TIME command is used to set the time-of-day, 
specified in 24-hour notation. The system keeps track of time in 
hours, minutes, and seconds, based on the initial time that you 
enter in the command. Enter the time as follows (there is only 
one format): 

Long and Short Command Format 

. TIME 15:01:00® 

If your system does not have a clock, the monitor prints a mes¬ 
sage on the terminal; this message informs you that the com¬ 
mand is not valid for your system configuration: 

7KMDN-M-N0 clocK 

Otherwise, the time is set to 3:01 p.m. If your system has a 
clock, reenter the correct time, using the same command 
format: 

TIME hh ss® 
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Typing the new time overrides the previous time. 

The system’s clock stops when the system stops running. If you 
want the time to be kept current, you must reenter it whenever 
you bootstrap the system. If your system has a clock and you do 
not set the time, the TIME command will return the time 
elapsed since the last hardware boot. 

To check the time or date at any time while you are using the 
system, simply type either the DATE command or the TIME 
command, followed by a carriage return only: 

Long and Short Command Format 

, DATE® 

8-JAN-83 
, TIME® 

ISrdB!19 

The system responds by printing the date or the time, based on 
the information you previously entered. If the system responds 
to the DATE command with the message ?KMON-W-No date, 
the date has not been set since the system was last 
bootstrapped. 


Each hardware device in the RT-11 system is identified by a 
two-letter mnemonic. The mnemonics, listed in Table 4-2, are 
defined in the system software and are recognized and used by 
the operating system. These are the device names that you gen¬ 
erally use in command input and output lines. However, you 
may want to change any of these device names temporarily, for 
a variety of reasons. The following paragraphs describe both 
using the physical device names shown in Table 4-2 and as¬ 
signing logical (temporary) device names to devices. 


Table 4-2 Physical Device Names 


Mnemonic 

Device 

DUn: 

RC25/RD51 Disk, RX50 Diskette 

DLn: 

RLOl/02 Disk 

DMn: 

RK06/07 Disk 

DXn: 

RXOl Diskette 

DYn: 

RX02 Diskette 

LP: 

Line Printer 

LS: 

Serial Line Printer 

MMn: 

TJU16 Magtape 

MSn: 

TSll Magtape 

MTn: 

TMll Magtape 

RKn: 

RK05/RK11 Disk 

TT: 

Console Terminal 


Assigning Logical 
Names to Devices 
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Two additional logical device names are used. These special 
names are described in Table 4—3. 


Table 4-3 Special Logical Device Names 


Mnemonic 

Device 

SY: 

The volume from which the monitor was 
bootstrapped; that is, the system volume. 

DK: 

The default storage volume (initially the same 
as SY:; that is, the system volume). 


You use device names in the input and output portions of a 
command line to identify where input information can be found 
and where output information will be sent. If a file is involved, 
you also include its file name and file type, in the following 
format: 

deVicename:fi 1 ename♦fi1etype 

The device name is followed by a colon and is always separated 
from any file name and file type by a colon. The device name is 
generally one of the mnemonics listed in Tables 4—2 and 4—3. 
When you use a device name in any command, you must also 
include the device unit number (represented by the letter n in 
Table 4-2) unless the number is 0. The system assumes unit 0 
of the device if no unit number is given. Thus, diskette unit 0 is 
DY: or DYO:; diskette unit 1 is DYl:; RK: disk unit 2 is RK2:; 
and so on. Note that, according to Table 4-3, you can use the 
device mnemonic SY: or DK: for your system volume in addi¬ 
tion to its standard device name. However, since the system 
volume is initially the default storage volume for all operations, 
you do not need to use a device name for your system volume. 

The names listed in Tables 4-2 and 4-3 are the device names 
defined within the system software. However, you can change 
any of these name assignments temporarily, either by reas¬ 
signing existing names to different devices or by assigning new 
logical names of your own choosing to devices. 

You might want, for many reasons, to change a device name 
temporarily and assign it a logical name. You may, for ex¬ 
ample, have a program written for a device that is not available 
on your system. If you assign the program name to a device that 
is available, the program then uses that device instead.^ 

Since not all RT-11 users have access to the same kind of 
storage volume, you are instructed to assign the logical name 
VOL: to whatever volume you are using for storage. After you 


‘This is called device independence. 
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make this assignment, subsequent command lines can be the 
same for everyone using this manual. 

Similarly, the special logical device name DK:, presently as¬ 
signed to your system volume, could be assigned to any kind of 
storage volume. Not only would DK: signify your storage 
volume, regardless of its physical device name, but you could 
also avoid typing DK: since it is the default storage volume for 
most commands. (Only the R command requires that the file 
specified be on the system volume SY:.) 

To assign a logical name to your storage volume, first deter¬ 
mine its physical device name. Check questions 7 and 8 in the 
Hardware Configuration section of Chapter 2 to see which de¬ 
vice and which device unit you are using for your storage 
volume. Translate this into the appropriate name and number 
using Table 4-2 as a guide. 

Use the monitor ASSIGN command to change this physical 
name to a logical name. Substitute for physical-device-name in 
the following command lines the physical name and device unit 
number for your storage volume (for example, for RK05 disk 
unit 1, substitute RKl:). 


ASSIGN 


Long Command Format 

. ASSIGN® 

Physical device name? Physica 1 -device-name® 
Logical device name? VOL:® 


Short Command Format 

, ASSIGN physical-device-name VOL:® 

Once the assignment is made, the system recognizes the logical 
name VOL: as the device name for your storage volume. This is 
the only logical assignment you need to make. Since you are 
not changing the DK: assignment, the system volume remains 
the default device for all I/O operations. 

As you continue to use the system, you may well make many 
device assignments and deassignments. To check the status of 
all assignments made during a computer session, you can use 
the monitor SHOW command to print on your terminal a list of 
all the logical assignments currently in effect. Use the SHOW 
command now to check the status of the assignment just made: 

Long and Short Command Format 

. SHOW® 


SHOW 
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Listing Voiume 
Directories 


DIRECTORY 


CTRL/0 


Check the list printed on your terminal to make sure that the 
code VOL: has been assigned to your storage volume. The let¬ 
ters VOL: should follow the appropriate device name in the list, 
as in the following response, in which VOL: represents disk 
unit 1: 


TT 

RK (Resident) 

RKO = SY t DK 
RKl = ^OL 
LD 
DX 
DT 
DD 
CT 
LP 
LS 
PC 
BA 
NL 

13 free slots 


Logical device assignments are temporary. Thus, if you want a 
logical device assignment to remain in effect, you must reassign 
it each time the system is bootstrapped. 


Both your system volume and your storage volume have direc¬ 
tories, which are compiled lists of all the files stored on the 
volume. You can print a volume directory on your terminal, 
using the monitor DIRECTORY command.^ To list the direc¬ 
tory of your system volume, type: 

Long and Short Command Format 

• DIRECTORY® (The system volume is the default device.) 

Since the directory of the system volume may be quite long, 
after approximately 10 lines have printed on the terminal, type: 

fcm/Q] 

This special control command, echoed as ""O, inhibits the re- 
mainder of the listing output from printing on the terminal, 
although the information on the total number of files and 
blocks is still given. When control returns to monitor command 
mode, look at the directory listing. At the top of the listing is 
today’s date, as you entered it earlier in the DATE command. 
Following the date is a list of the files on the volume. Notice the 
two-column format of each line in the directory. 

‘Users of VTll display hardware may wish to use the CTRL/E command to 
enable both the graphics screen and the terminal printer for the following 
exercises. 
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08-Jan-83 
SWAP .SYS 

28 

2B-AUS-82 

RTllSJ 

.SYS 

73 

26-Autf-82 

RTllFB.SYS 

86 

2B-AU1I-82 

RTllBL.SYS 

73 

2B-Aui-82 

RTllXM.SYS 

94 

2B-Autf-82 

TT 

.SYS 

2 

2B-Autf-82 

DT .SYS 

3 

2B-Autf-82 

DP 

.SYS 

3 

26-Au^-82 

DX .SYS 

3 

2B-Autf-82 

DY 

.SYS 

4 

26-Au^-82 

RF .SYS 

3 

2B-AUS-82 

RK 

.SYS 

3 

2G-Autf-82 

DL .SYS 

4 

26-Au^-82 

DU 

.SYS 

4 

2B-Auf-82 

DM .SYS 

5 

2B-Au^-82 

DS 

.SYS 

3 

2B-Autf-82 

DD .SYS 

5 

2S-Autf-82 






170 Files * aZBd BlocKs 
498 Free blocKs 


First the file name appears, followed by a dot and a file type 
that is frequently used to identify the file’s format. For exam¬ 
ple, .SYS represents a system file; other RT-11 file types used 
to represent different kinds of files are listed in Table 4-4. Af¬ 
ter the file type is a number that indicates the size of the file. 
The size is given in blocks, a term used to designate a standard 
amount of information. A file that is 1 to 10 blocks long is fairly 
small, while a file over 100 blocks in length is quite large. The 
date on which the file was created is shown at the right. This 
space is empty if a date was not specified (with the DATE cpm- 


Table 4-4 File Types 


File Type 

Meaning 

.BAG 

BASIC compiled file 

.BAK 

Editor backup file 

.BAS 

BASIC source file 

.BAT 

BATCH source file 

.BUP 

Backup/restore file 

.COM 

Indirect command file or IND indirect control file 

.CTL 

BATCH control file 

.DAT 

BASIC-11 or FORTRAN IV data file 

.DBL 

DIBOL source file 

.DIF 

SRCCOM output file 

.DIR 

Directory listing file 

.DSK 

Logical disk file 

.FOR 

FORTRAN IV source file 

.LOG 

Batch log file 

.LST 

Listing file 

.MAC 

MACRO—11 source file 

.MAP 

Linker map file 

.MLB 

MACRO library file 

.OBJ 

MACRO-11, FORTRAN IV, or DIBOL object out¬ 
put file or library file 

.REL 

Executable foreground program file or system job 

.SAV 

Executable background program file 

.SML 

System MACRO library 

.SYS 

System files and handlers 
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mand) on the day the file was created. At the end, you are told 
how many files are on the volume, their total length, and the 
number of free blocks available for your use. 


DIRECTORY 

/BRIEF 


CTRL/C CTRL/C 


DIRECTORY 

/PRINTER 


NOTE 

Files furnished on the distribution mediurn have a pro¬ 
tected status, which means they cannot be deleted. This 
is indicated by the letter P after the file size shown when 
you print a directory listing. You cannot perform any op¬ 
eration on a protected file if the result is to delete it. You 
can change the protected status of a file by using the 
RENAME keyboard monitor command with the /PRO¬ 
TECTION or /NOPROTECTION option; you can give a 
protected status to a file by using the PROTECT key¬ 
board monitor command; and you can remove a pro¬ 
tected status from a file by using the UNPROTECT key¬ 
board monitor command (see the RT-11 System User’s 
Guide). 

You can also obtain an abbreviated directory, which omits file 
lengths and dates and lists only file names and file types in 
five-column format. To do this, you use the DIRECTORY com¬ 
mand with its /BRIEF option. Type the following, and after 
several lines have listed, interrupt the directory by typing two 
CTRL/C command characters. This double control command 
echoes two 'Cs and requests the running program to abort im¬ 
mediately, regardless of what the program is doing (one 
CTRL/C aborts an executing program waiting for input from 
the console terminal). Control returns to monitor command 
mode. 

Long and Short Command Formats 

, DIRECTORY/BRIEF® 

08-Jan-83 

SWAP .SYS RTllSJ.SYS RTllFB.SYS RTllBL.SYS RTllXM.SYS 
TT .SYS DT .SYS OP .SYS OX .SYS DY .SYS 

RF .SYS RK .SYS DL .SYS DU .SYS DM .SYS 

DS _ .SYS DD .SYS LP .SYS LS .SYS CR .SYS 

fcTRLfC IfcTRLiC I 

Volume directories can be printed on a line- printer if one is 
available on your system. Check the answer to question 9 in the 
Hardware Configuration section of Chapter 2 to determine if 
your system has a line printer. Since listings print faster on a 
line printer than on the console terminal, it is to your advan¬ 
tage to use the line printer for large amounts of output. The 
/PRINTER option is used with the DIRECTORY command to 
cause a directory to be printed on the line printer instead of on 
the terminal. Make sure your line printer is turned on, and 
then type the DIRECTORY command as shown: 
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Long and Short Command Format 

. DIRECTORY/PRINTER® 

The listing may be quite long. When the line printer has fin¬ 
ished printing, retrieve the listing. 


Initializing a storage volume clears its directory. A new 
(unused) volume should always be initialized before it is first 
used. In addition, any storage volume that contains files that 
are no longer needed can be initialized to recover the storage 
space. Note, however, that an initialize operation is used to 
remove all file names from the directory. So before you ini¬ 
tialize a volume, make sure that it contains no files that you 
might want later. 

Since you will use your storage volume to store several new 
files (created as a result of the various exercises in this 
manual), clear its directory using the monitor INITIALIZE 
command. This operation ensures that the volume has room for 
new files. 

Long Command Format 

. INITIALIZE® 

Device? MOL:® 


RK1:/Initia 1 i 2 e5 Are you 

Short Command Format 

. INITIALIZE VOL:® 

RK 1 : / I n i t i a 1 i z e i Are you sure? Y® 

The system prompt physical-device-namellnitialize; Are you 
sure? gives you an opportunity to verify the command. Typing a 
Y initiates the operation, while N stops the operation and re¬ 
turns control to the monitor command mode. Check your com¬ 
mand line, make sure you are initializing your storage volume, 
and then t3q)e a Y. Again, list the directory of the storage 
volume. It should be empty. 

Long and Short Command Formats 

. DIRECTORY VOL:® 

8-Jan-83 

0 Files# 0 BlocKs 
4782 Free blocks 

The number of blocks available for use on the volume is printed 
at the end of the directory and varies depending on the type of 
device you use as your storage volume. 


(VOL: is the assigned logi¬ 
cal device name for your 
storage volume.) 

sura? Y (HU) 


Initializing the 
Storage Volume 


INITIALIZE 
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The commands you have performed in this chapter have pre¬ 
pared the system for major operations that will follow. In 
Chapter 5 you begin by using the RT—11 editor to create text 
files that you will store on your initialized storage volume. 


SUMMARY: 

INITIAL 

MONITOR 

COMMANDS 


ASSIGN physical-device-name logical-device-name 

Assign a logical device name to a physical device name. 

DATE 

Print the current date, if previously set. 

DATE dd-mmm-yy 

Set the current date (day-month-year). 

DIRECTORY ddn: 

List the volume directory on the terminal (ddn: is the mne¬ 
monic for the device name; the default storage volume, DK:, 
is assumed if ddn: is not specified). 

DIRECTORY/BRIEF ddn: 

List a brief volume directory on the terminal, showing only 
file names. 

DIRECTORY/PRINTER ddn: 

List the volume directory on the line printer. 

DIRECTORY/PRINTER/BRIEF ddn: 

List a brief volume directory on the line printer. 

GT OFF 

Disable the VTll display hardware. 

GTON 

Enable the VTll display hardware so that the graphics 
screen replaces the terminal printer/screen as the terminal 
output device. 

INITIALIZE ddn: 

Clear the directory of the indicated volume (ddn: is the mne¬ 
monic for the device name and must be specified). 

SHOW 

Print the status of all current logical device name assign¬ 
ments. 

TIME 

Print the current time, if previously set. 

TIME hh:mm:ss 

Set the current time-of-day (hour:minute:second). 
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CTRL/C CTRL/C 

Interrupt the current operation or program and return con¬ 
trol to monitor command mode. 

CTRL/E 

Direct terminal output to both the graphics screen and the 
terminal printer simultaneously. Type a second CTRL/E to 
return output control to the graphics screen only. (Valid only 
when VTll display hardware is enabled.) 

CTRL/0 

Inhibit the remainder of output from printing on the termi¬ 
nal. 

CTRL/U 

Cancel every character in the current line. 

DELETE 

Cancel the last character typed on the current line. 


LPll/LSll Line Printer Manual (EK-LPll-TM-005). Maynard, Mass.; 
Digital Equipment Corporation, 1975. 

A hardware manual for the owners and operators of LPll/LSll line 
printers and for those who will be programming computers to interact 
with these devices. 

RT-11 Mini-Reference Manual (AA-M241A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A summary of all RT-11 monitor commands, command options, system 
utility program operating commands, and programmed requests. 

RT-11 System User’s Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT-11 operating system. 


SUMMARY: 

SPECIAL 

CONTROL 

COMMANDS 


REFERENCES 
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CHAPTER 5 

CREATING AND EDITING TEXT FILES 


The ability to create and edit text files is one of the most useful 
features of the RT-11 operating system. Not only can you 
create computer programs, data files, memos, and reports on 
line (that is, under the control of the system), but you can alter 
what you create without retyping the entire file. 

You create and edit text files more often than you perform any 
other system operation. Therefore it is essential that you be¬ 
come familiar with the editing process as quickly as possible. 
Editing should become second nature to you as you learn to use 
the RT-11 computer system. 


Two RT-11 editor system utility programs, EDIT.SAV and THE RT—11 EDITOR 

KED.SAV, are stored as part of the RT-11 operating system on 
your system volume. The demonstrations in this manual illus¬ 
trate EDIT, which can be used on a video terminal or a hard¬ 
copy terminal. The use of KED is restricted to video terminals. 

For more information about KED, refer to the PDP-11 Keypad 
Editor User’s Guide. 

Text files that you create with the editor are stored in the com¬ 
puter in ASCII format. ASCII, which stands for the American 
Standard Code for Information Interchange, is an industry- 
standard code that consists of a numeric representation for each 
of the alphabetic characters (A to Z), the numeric characters (0 
to 9), the punctuation characters, and some special communica¬ 
tion control characters. When you type text on the terminal 
keyboard, the system automatically converts the text to ASCII 
codes; when you request listings on the terminal or line printer, 
the system converts the ASCII code back to the text characters. 

The RT-11 editor uses a specially reserved area of computer 
memory to hold the text you are creating or editing. This area 
of memory is called the text buffer. When you create text, the 
characters that you t 5 q)e on the terminal keyboard are 
transmitted directly into the text buffer. When you edit text, 
the characters are copied from the input file into the text 
buffer, where you can modify them. When you have edited the 
text in the buffer to your satisfaction, the characters are moved 
out of the text buffer to the output file (Figure 5-1). 
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COMPUTER 



Figure 5-1 Editing with RT-11 

Since the text buffer is a limited area of computer memory, you 
may at times try to input more text than the buffer can accom¬ 
modate. If this condition becomes apparent to the editor, it 
prints a warning message on the terminal telling you that, be¬ 
fore you can input any more text, you must make room in the 
buffer, either by transferring text to the output file or by 
erasing text already in the buffer. 

You can avoid this inconvenience during editing if you make 
use of a concept called paging. When you create a large text file, 
instead of typing the file as one long stream of text, divide it 
into individual pages of approximately 50-60 lines in length; 
this corresponds roughly to the size of a line printer or terminal 
listing page. You can copy the text into and out of the buffer 
one page at a time. A single page of text is never too large for 
the text buffer and also fits on the line printer or terminal 
perforated paper when you obtain a listing. 


CREATING A 
TEXT FILE 


EDIT/CREATE 


You activate the editing capability by using the monitor EDIT 
command. When creating a file, you must use the /CREATE 
option followed by the file name and file type you want as¬ 
signed to the new file. The default storage volume (DK;) serves 
as the default device, so unless you specify a device using one of 
the mnemonics in Table 4-2, the editor creates the new file on 
the device DK: (which is the system volume, unless changed via 
ASSIGN). 

First, if you are using display hardware, disable it with the 
monitor GT OFF command; the editor has a special display 
capability that is not described until later in this chapter. 

Long and Short Command Format 

GT OFF® 
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Next, use the editor to create a text file of five lines. Call the 
file DECIND.USA, and use the default storage volume — cur¬ 
rently the same as the system volume — for the file. 

Long Command Format 

. EDIT/CREATE® 

File? DECIND.USA® 


Short Command Format 

. EDIT/CREATE DECIND.USA® 

Once the output file is open (that is, when the appropriate file 
has been established for output operations), the editor prints a 
prompting asterisk at the left margin. The asterisk indicates 
that the editing command mode is in control. This prompt is 
your cue to enter an editing command. 

The editing command used to create text is the I (Insert) com¬ 
mand. T 5 rpe: 

* I 

All subsequent characters that you type on the terminal key¬ 
board will now be entered into the text buffer just as you type 
them. Enter the following text exactly as shown, including all 
spaces and errors. Before you type the RETURN key, check the 
line to make sure that it matches what is shown here. Re¬ 
member, if you make a typing mistake that is not intentional, 
you can use the DELETE key on the terminal keyboard to erase 
individual characters and the CTRIAJ command to erase all 
characters on the current line. When you have finished t 5 T)ing 
the five lines, type the ESCAPE key twice. The ESCAPE key 
echoes on the terminal as a $; it is used to execute an editing 
command and to return control to editing command mode. 

♦ IWE HOLD THESE TRUTS TD BEE SELF-EOI DENT .® 

THAT ALL MEN ARE CREATED EQUAL. THAT THEY® 

HAVE UNRELIABLE TENDENCIES DF WHICH THEY® 

AR ENDOWED BY THEIR CREATOR. THAT AMONG® 

THESE ARE LIFE. LIBERTY AND HAPLENESS.® 

•* 


Forget for the moment that this text contains several misspell¬ 
ings and other errors, and assume instead that you are satisfied 
with it and ready to transfer it from the text buffer to the 
output file. The EX (Exit) editing command performs this func¬ 
tion. This command terminates editing, transfers all text in the 
text buffer to the output file, closes the currently open output 


INSERT 


ESCAPE ESCAPE 


EXIT 
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EDITING A 
TEXT FILE 


EDIT 


READ 


BEGINNING 


file (making it unavailable for further output operations), and 
returns control to monitor command mode, indicated by a dot at 
the left margin. Use the EX command to close the file 
DECIND.USA: 

* EX {DUD 

You now have a file on your system volume called 
DECIND.USA, consisting of the five lines of text you just cre¬ 
ated. 


The file DECIND.USA needs editing. To edit a file, you again 
use the EDIT command to activate the editor. Next indicate in 
the command line the two-letter device mnemonic for the 
volume on which the file resides (the default storage volume, 
DK:, is assumed). Following this, you indicate the file name 
and file type of the file. The editor then opens the file, making 
it available for input operations. 

Thus, to open the file DECIND.USA for editing, type: 

Long Command Format 

♦ EDIT® 

File? DECIND.USA® 

Short Command Format 

• EDIT DECIND.USA® 

The EDIT command opens the input (and output) files. Use the 
R (Read) editing command to read the first page of text from the 
input file into the text buffer. No output occurs to the output 
file, but the file is available for output at a later time. The 
input file itself is not altered in any way. 

R HE)® 


Whenever text is read into the text buffer, a pointer is automat¬ 
ically positioned at the beginning of the text. This pointer is an 
invisible indicator that serves as a target for editing commands. 
The pointer pinpoints the exact location in the file where the 
next character will be inserted. For example, when you finished 
inserting text earlier (just before using the EX command), the 
pointer was positioned at the end of the file. Now that the EDIT 
command has been used to read text into the text buffer, the 
pointer is positioned at the beginning of the text in the text 
buffer. If the pointer is not at the beginning and you want to 
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move it there, you can use the B (Beginning) command; this 
command moves the pointer to the beginning of the text in the 
text buffer, no matter where the pointer is currently positioned; 

0 @@ 

* 


With the pointer positioned at the beginning of the text buffer, 
you can use the L (List) editing command to list the text cur¬ 
rently in the text buffer on your terminal printer. The List 
command lists text, starting at the . pointer and continuing to 
whatever place you indicate by the command argument. 

A command argument is simply a prefix to an editing command 
that sets limits on the command’s actions. Command argu¬ 
ments are used frequently and are summarized in Table 5-1. 
Study this table for a moment before continuing. 


Table 5-1 Command Arguments 


Argument 

Meaning 

n 

Represents any integer in the range -16383 to 
+16383; it* may be preceded by a + or -. If no 
sign precedes n, it is assumed to be positive. 
Whenever an argument is acceptable in a com¬ 
mand, its absence implies an argument of 1 (or 
-1 if only the - is present). 

0 

Refers to the beginning of the current line. 

/ 

Refers to the end of text currently in the text 
buffer. 


Thus, with the pointer positioned at the beginning of the text, 
use the / argument and the L command to list on the terminal 
all text in the buffer. The position of the pointer does not 
change. List the text and compare your output with the five 
lines shown in the following example — they should match ex¬ 
actly. 

/u (HKlSl 

* 

WE HOLD THESE TRUTS TO BEE SELF-EVIDENT, 

THAT ALL MEN ARE CREATED EQUAL, THAT THEY 
HAVE UNRELIABLE TENDENCIES OF WHICH THEY 
AR ENNDOWED BY THEIR CREATOR, THAT AMONG 
THESE ARE LIFE, LIBERTY AND HAPLENESS* 

* 

If your output and the five lines above do not match exactly, 
then you probably typed some unintentional errors into 
DECIND.USA. 


LIST 
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The remaining EDIT commands in this exercise depend upon 
an exact reproduction of DECIND.USA to function properly. 
Therefore, since you are not yet familiar with the EDIT com¬ 
mands necessary to correct your file, an existing copy of 
DECIND.USA with intentional errors must be substituted. 

Prepare the text buffer by erasing it with CTRL/CUD®. This 
unusual command combination is required by the EDIT pro¬ 
gram when you want to exit without creating an output file. 
The structure of the command prevents you from accidentally 
eliminating a file with a single CTRL/C. 

* Cm;ci (Es5)(!sa 

The monitor command mode period appears, signaling your de¬ 
parture from the editing command mode. Your system volume 
still contains the file DECIND.USA that you created earlier. 
However, it also contains the copy provided with the system, 
DEMOED.TXT, which you will use for the remainder of the 
exercise. 

Before going any further, you must rename DEMOED.TXT to 
DECIND.USA to avoid confusion. A RENAME operation, ex¬ 
plained fully in the File Copying Operations section of Chapter 
7, is the method of choice. Type the following command: 

* RENAME DEMOED.TXT DEC IND.USAESI 

The contents ofDEMOED.TXT are now labeled DECIND.USA. 
Note, however, that if a file labeled DECIND.USA already ex¬ 
ists and you rename another file to DECIND.USA, the system 
deletes the first file named DECIND.USA and renames the cur¬ 
rent one. Type EDIT DECIND.USA ® to open the file for 
input, and type the R command to read it into the text buffer. 

* EDIT DECIND.USA® 

* r®iid 

Since the pointer automatically returns to the beginning of the 
text with an R command, you can t)T)e /L to list the entire file. 

* /\_ ig)® 

Wt: HOLD THESE TRUTS TO DEE SELF-EVIDENT. 

THAT ALL MEN ARE CREATED EQUAL. THAT THEY 
HAVE UNRELIABLE TENDENCIES OF WHICH THEY 
AR ENDOWED BY THEIR CREATOR. THAT AMONG 
THESE ARE LIFE. LIBERTY AND HAPLENESS. 

•* 
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The text contains errors and misspellings deliberately intro¬ 
duced for the purposes of the exercises in this chapter. To cor¬ 
rect the errors, reposition the pointer so that it is near the text 
you want to change. The J (Jump) command, for instance, in 
conjunction with a command argument, moves the pointer ei¬ 
ther backward or forward by the specified number of charac¬ 
ters, including spaces. Type the J command now, using an argu¬ 
ment of 18, to reposition the pointer 18 places ahead^: 

^ isJdDdD 
* 


JUMP 


Although you cannot see it, the pointer has moved from the 
beginning of the text buffer to the right of the 18th character. 
You can verify this by using the List command again. The List 
command with no argument prints from the pointer to the end 
of the current line and thus exposes the location of the pointer: 

^ L ©HE) 

S TO BEE SELF-EVIDENT . 

# 

The characters in the example should match the current line on 
your terminal, showing the pointer positioned at the first error 
in the text where an H is missing in the word TRUTS. Since the 
pointer is positioned between the second T and the S, use the 
Insert command to insert an H in the proper place: 


^ IH@)(eD 


Now use the V (Verify) command to verify the line. The V com¬ 
mand, which does not require arguments, prints the entire line 
containing the pointer (the current line) on the terminal. It 
allows you to verify that a correction was properly made. The 
pointer is not moved as a result of the V command; its position 
remains just to the right of the last inserted character (shown 
here by the arrow): 


VERIFY 


^ V IDID 

WE HOLD THESE TRUTHS TO BEE SELF-EVIDENT* 

* T 

^Anytime you use the Jump command to move the pointer forward (or back¬ 
ward) by enough characters so that it moves to a new line, you must account 
for two extra characters in the command argument. This is because the editor 
treats the carriage return at the end of each line as two characters — a 
return and a line feed. 
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So far you have entered and executed editing commands one at 
a time. You can enter multiple commands by separating each 
individual command with a single ESCAPE. Typing two ES¬ 
CAPES then executes all the commands in the entire command 
string in consecutive order. For example, combine the J and L 
commands as shown in the following command string: 

* 7J(®IL(is?)® 

E SELF-EVIDENT* 

* 

The 7J moves the pointer seven positions to the right, and L 
then lists the text from the pointer to the end of the line so that 
you can see the pointer’s new position. 

A special CTRL command is available to erase multiple editing 
commands. The CTRL/X command (hold the CTRL key down 
and type the X key) causes the editor to ignore an entire com¬ 
mand string that might extend Over several lines if the I com¬ 
mand is involved. The editor echoes with 'X, issues a carriage 
return, and prints an asterisk indicating that you are still in 
editing command mode and can enter a new command. For ex¬ 
ample, type: 

♦ 70J@ISTART A® 

NEW LINE emT\ 


CTRL/X 


DELETE 


In addition to the CTRL/X command, you may still use the 
DELETE key to erase individual characters in the command 
line one at a time, and the CTRL/U command to erase all char¬ 
acters entered on the current command line. 

Since you used the CTRL/X to ignore this last command string, 
the pointer is still positioned at the next error in the 
file — just before the extra E in the word BEE. You can erase 
this extra character by using the D (Delete) command.^ The D 
command removes one . character (or space) to the right of the 
pointer for every -I- 1 in its argument and one character to the 
left for every -1. Use the D command to erase the extra E and 
then verify the line ( -I- 1 is assumed if no argument is used): 


♦ D(iEiv@(iEi 

WE HOLD THESE TRUTHS TO BE SELF-EVIDENT* 

# t 


^The Delete command should not be confused with the DELETE key on the 
terminal keyboard. While both perform the delete function, the D command is 
used to erase characters already within a text file; the DELETE key is used to 
erase typed characters in a command string or during text creation. 
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As you can see from the position of the pointer in the example 
(shown by the arrow), the D command does not actually move 
the pointer, but simply erases characters around the pointer. 
Since the extra E was erased, the pointer is now positioned 
between the E and the space. 

Just as you can use the Jump command to move the pointer by 
characters, you can use the A (Advance) command to move the 
pointer by entire lines. Again you give the command an argu¬ 
ment that indicates the number of lines, either forward or back¬ 
ward. The pointer is positioned at the beginning of the new 
line. Use the A command to move the pointer forward two lines, 
and then list the current line: 

» ZAdDLdl)®) 

HAVE UNRELIABLE TENDENCIES OF WHICH THEY 
* 


ADVANCE 


This entire line does not belong in the text. To erase it, you 
could count the number of characters in the line and use this 
number as an argument to the D command; however, there is 
an easier way. The K (Kill) command erases the entire line 
following the pointer and positions the pointer at the beginning 
of the next line in the text. Type: 

* KlElLfEXic) 

AR ENDOWED BY'THEIR CREATOR* THAT AMONG 

* 


The pointer is now at the beginning of the next line in the text. 
As you can see, this line also contains an error, the word ARE is 
incorrectly spelled as AR. Use the J command to jump over two 
characters, and insert the E. Then verify the line: 

» 2Je)IE(iE)U(li9(ES0 

ARE ENDOWED BY THEIR CREATOR. THAT AMONG 

* t 


The arrow shows where the pointer is now positioned. This line 
still contains an error — it is missing the words WITH CER¬ 
TAIN INALIENABLE RIGHTS, which should follow the word 
CREATOR. You can count the number of characters from the 
pointer to the second R in CREATOR and then jump the pointer 
by this number, or you can use the G (Get) command. The G 
command searches, from the pointer, for the first occurrence of 
a specified character string and leaves the pointer at the end of 
that string. Use the G command to search for the string OR (in 
CREATOR); then insert the missing words and list the lines 
that have changed. Notice how you use the carriage return to 


KILL 


GET 
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break the line into two parts (the HE) symbol is used to show 
where you should insert spaces): 

* GOR@I@WITHIiE)CERTAIN® 
INALIENABLElElRIGHTSiSl-AdSlZLSDdll 

ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS* THAT AMONG 

* 

To list both lines, it was necessary to move the pointer back to 
the beginning of the first line you changed; this was done by the 
-A command. The 2L command then listed both lines. Notice 
where the pointer is; it was moved by the -A command and was 
not repositioned by the L command. 

You must be careful when you use the Get command, because 
the character string you specify must be vmique if you want the 
pointer to move to the correct spot. For example, if the charac¬ 
ters OR had occurred anywhere after the pointer and before the 
word CREATOR, the pointer would have stopped there instead, 
and you would have inserted text in the wrong place. 

The final errors in this text occur in the last line. The words 
THE PURSUIT OF are missing, and the word HAPLENESS is 
a misspelling. Use the Get command to move the pointer to the 
word AND and insert the missing text. Move the pointer again 
with the Get command to the PLE of HAPLENESS; erase the 
LE, and insert PI. Then verify the line: 

* GAND(lDl(iE)THEi!)PURSUIT@OF(lD® 

* GPLE®-2DlDlPI®V(iEl(iE) 

THESE ARE LIFE* LIBERTY AND THE PURSUIT OF HAPPINESS. 


CTRL/L 


Large text files — 50 lines or more — should be delimited 
into pages. To do this, insert a form feed into the text at the 
place where you want the page to end. A form feed is typed as a 
CTRL/L (hold the CTRL key down and type the L key), which 
the editor recognizes as a page break. 

Since this text file is only five lines long, there is really no need 
to delimit it as a page. However, for the sake of practice, insert 
a form feed at the end of this file. Then move the pointer to the 
beginning of the text buffer and list the entire text. Compare 
your text with the following example. If errors remain in your 
file, fix them by using the commands described so far. 


**G.@I® 

®ZD (CTRL/L echoes as eight line feeds.) 
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(Idbid/l®® 

WE HOLD THESE TRUTHS TO BE SELF-EVIDENT» 

THAT ALL MEN ARE CREATED EQUAL» THAT THEY 
ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS. THAT AMONG 

THESE ARE LIFE. LIBERTY AND THE PURSUIT OF HAPPINESS. 




This text is correct in spelling and content, but the last two 
lines should be justified to make them easier to read. The 
pointer is currently at the beginning of the text. Use the G 
command to search for the character string AMONG; then in¬ 
sert and delete text to justify the lines. Finally, list the text 
again: 


* '-GAMONGlElIigTHESE® AREdDA® 1 ODfElBlll/L®® 
WE HOLD THESE TRUTHS TO BE SELF-EVIDENT. 

THAT ALL MEN ARE CREATED EQUAL. THAT THEY 
ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS. THAT AMONG THESE ARE 
LIFE. LIBERTY AND THE PURSUIT OF HAPPINESS. 


* 

Once you are satisfied with your text, you are ready to transfer 
it to the output file. You could use the EX command to transfer 
the text, as you did earlier in the section Creating a Text File. 
However, suppose your input file has additional pages of text 
that require editing. If you use the EX command, all remaining 
text in the input file will be read through the text buffer into 
the output file, and the files will be closed although you may 
want to do more editing. To avoid this, you can use the N (Next) 
command. This command transfers the text currently in the 
text buffer to the output file, clears the text buffer, and reads in 
the next page from the input file. The pointer is positioned at 
the beginning of the text buffer. 

« iN®® 

?EDIT-F-End of input file 

* (No text remains in the input file.) 

If you use the N command when no text remains in the input 
file (as just happened), the editor prints a message on the ter¬ 
minal telling you so. At this point, you can type the EX com¬ 
mand to close the file. 

, ex®® 


NEXT 
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When you close a file after editing, the editor creates a file on 
the default storage volume (or system volume). It gives this 
new file the file name and file type that you indicated for input. 
It then renames the input file so that the file retains its file 
name but is assigned a file type of .BAK. This file type identi¬ 
fies a backup file, here an original input file retained in case of 
editing mistakes or accidental deletion of the new file. Thus you 
now have two versions of the DECIND file on your system 
volume: DECIND.USA, which is the edited version, and 
DECIND.BAK, which is the unedited (original) input file. 
Verify this by using the monitor DIRECTORY command: 

Long and Short Command Format 

• DIRECTORY DECIND.*® 

DECIND^BAK 1 OB-Jan-83 DECIND.USA 1 08-Jan-83 

2 Files » 2 Blocks 
A9G Free blocks 


The asterisk (*) following DECIND. is a type of shorthand nota¬ 
tion called wildcard construction. Here it means to list all files 
named DECIND, regardless of their file type. Wildcard con¬ 
struction is explained in detail in the Multiple File Operations 
section of Chapter 7. 

Whenever you edit the same file a number of times, new ver¬ 
sions overwrite old versions. Thus only two versions of the 
edited file (filnam.BAK and filnam.typ) ever reside on a volume 
at one time. 


USING UPPERCASE 
AND LOWERCASE 
CHARACTERS 


Edit Lower 


Later model terminals (for example, LA120 DECwriters and 
VTIOO video terminals) have the capability to print in upper¬ 
case and lowercase. Certain line printers also have this capa¬ 
bility. You can use the uppercase/lowercase capability of these 
devices if you type the EL (Edit Lower) editing command before 
entering the text you want to insert in lowercase. The EL com¬ 
mand instructs the system to accept all characters typed as 
they appear on the keyboard. The monitor facility, which con¬ 
verts all alphabetic characters to uppercase, is disabled. In ad¬ 
dition, the characters are echoed on the terminal printer or 
screen as uppercase and lowercase characters. 

Open the file DECIND.USA again, and type the EL command: 

Long and Short Command Format 

.EDIT DECIND.USA® 

tELdDID 

* 
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Once you have typed the EL command, you can use the SHIFT 
key on the terminal to designate uppercase, just as you do on a 
typewriter. Editing commands may be entered as either upper¬ 
case or lowercase characters. For example, type the following 
commands, which change the characters in the first line of the 
file DECIND.USA to uppercase and lowercase: 

« rIDb®!®® 

WE HOLD THESE TRUTHS TO BE SELF-EVIDENT. 

* KdEliWe hold these truths to be self-evident.® 

We hold these truths to be self-evident. 

* 

The uppercase and lowercase capability is useful for reports, 
memos, and other textual material that you list on 
uppercase/lowercase devices. However, all characters are 
printed as uppercase if you list the file on a line printer or 
terminal that does not have the uppercase/lowercase capability. 

If at any time you want to revert to strictly uppercase editing, 
t5T)e the EU (Edit Upper) command: 

eudlKiD 

Uppercase editing is a default mode. Whenever you open a file 
for editing or create a new file, you must enter the EL command 
if you want to use the uppercase/lowercase capability. 

Close the file DECIND.USA by typing: 

* EX®® 


EDIT filespec 

Activate the editor and open the file for editing. 

EDIT/CREATE filespec 

Activate the editor and create a new file. 

Control Commands 
CTRL/L 

Insert a form feed. The form feed character is used to delimit 
pages of text in a file (introduced as part of text by the Insert 
command). 

CTRL/X 

Ignore all commands in the current editing command string. 


Edit Upper 


SUMMARY: 

EDITING 

COMMANDS 
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Command Arguments 

n(+ or-) 

An integer value between -16383 and +16383 that sets the 
range of a command’s actions based on the pointer’s current 
position. 

0 

Beginning of the current line (the line containing the 
pointer). 

/ 

End of the text in the text buffer. 


Input/Output Commands (pointer is not repositioned) 

(x indicates that an argument can be used) 

EX 

Exit; terminate editing, transfer the contents of the text 
buffer and the remainder of input file to the output file; close 
input and output files; return to monitor command mode. 

xL 

List; list, from the pointer, x lines of text. 
xN 

Next; write the contents of the text buffer to the output file, 
clear the text buffer, and read into it the next page from the 
input file; perform this write/read sequence x times. 


V 

Verify; list the current line (the line containing the pointer) 
on the terminal. 

Pointer Location Commands (pointer is repositioned) 

(x indicates that an argument can be used) 

xA 

Advance; move the pointer to the beginning of the xth line 
from the current pointer position. 

B 

Beginning; move the pointer to the beginning of the text 
buffer. 


xJ 

Jump; move the pointer forward or backward by x characters. 
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Text Modification Commands (pointer is repositioned) 

(x indicates that an argument can be used) 

xD 

Delete; erase x characters to the right (or left) of the pointer. 

I text HD 

Insert; insert text into the text buffer at the present pointer 
position. 

xK 

Kill; erase x lines of text, beginning at the pointer. 

Search Command (pointer is repositioned) 

(x indicates that an argument can be used) 

xG text 

Get; search the text buffer, beginning at the pointer, for the 
xth occurrence of the indicated text string and leave the 
pointer at the end of the text string. 

Uppercase/Lowercase Commands (pointer is not affected) 
EL 

Edit Lower; accept characters typed at the keyboard as 
uppercase/lowercase. 

EU 

Edit Upper; revert to uppercase editing (after EL). 


If your system configuration includes VTll display hardware, 
there are several advantages to your using it during editing.^ 
First, the graphics screen becomes a window into the text 
buffer, exposing twenty lines of text at a time: the current line, 
the ten lines preceding it, and the nine lines following it. 
Figure 5-2 illustrates this format. As you edit, the lines in view 
shift to conform to the current line. In addition, the pointer is 
visible and appears as a blinking, L-shaped cursor. Its position 
is automatically adjusted as you execute editing commands. Fi¬ 
nally, the four lines at the bottom of the screen display the last 
three command lines plus the current command line. Hori¬ 
zontal dashes separate the text of the file from your commands. 


USING A 
GRAPHICS DISPLAY 
TERMINAL 
DURING EDITING 


your system does not have VTll display hardware, skip to the next sec¬ 
tion, entitled Creating the Demonstration Programs. 
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Normal Use of the 
Graphics Display 


Immediate Mode 


10 PRECEDING J 
LINES OF TEXT ' 


CURSOR 
(CURRENT LINE 

AND 9 
FOLLOWING 
LINES OF TEXT 


SEPARATION 
LINE 

3 PRECEDING J 
COMMAND LINES 1 
CURRENT 
COMMAND LINE 



WINDOW 
)lNTO THE 
TEXT BUFFER 


Figure 5-2 Text Window Format 


All editing commands and functions described so far can be 
used when the graphics screen is enabled. The only difference is 
that terminal I/O is rearranged on the screen as shown in 
Figure 5-2. Note that the L and V editing commands become 
superfluous since the pointer is always displayed on the screen. 
Also, since twenty lines of text are always displayed, any List 
command within that range is unnecessary. 

Currently, your graphics screen is not enabled. To enable it, use 
the monitor GT ON command as you did in Chapter 4: 

Long and Short Command Format 

, GT ON® 

Now when you use the EDIT command to activate the editor, 
the graphics screen will be rearranged as shown in Figure 5-2. 
You can use the CTRL/E command, described in Chapter 4, to 
request simultaneous I/O on the terminal printer and graphics 
screen. 


In addition to the regular editing capability, a quick and easy 
method of graphics editing, called immediate mode, is avail¬ 
able. Immediate mode uses a simplified set of editing com¬ 
mands that are limited to pointer relocation and character dele¬ 
tion and insertion. Most of these commands are similar to the 
special CTRL commands because to type them you use the 
CTRL key in combination with another character key. How- 
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ever, the use of these particular control commands is mean¬ 
ingful only in the editor immediate mode. Table 5-2 lists the 
commands. 


Table 5-2 Immediate Mode Co mman d.*; 


Command 

Meaning 

CTRL/N 

Advance the cursor to beginning of next line 
(equivalent to A). 

CTRL/G 

Move the cursor to the beginning of the previous 
line (equivalent to -A). 

CTRL/D 

Move the cursor forward by one character (equiv¬ 
alent to J). 

CTRLA^ 

Move the cursor back by one character (equiva¬ 
lent to -J). 

DELETE 

Delete the character immediately preceding the 
cursor (equivalent to -D). 

ESCAPE 

Return control to the editing command mode. 

double 

ESCAPE 

Summon immediate mode. 


Use the editor to open a new file called IMMODE.TXT: 


Long and Short Command Format 

. EDIT/CREATE IMMODE.TXT® 


Now activate immediate mode. You do this by typing the ES¬ 
CAPE key twice in response to the editing command mode as¬ 
terisk. Since there are no other commands in the command line, 
the editor recognizes the double ESCAPE as an immediate 
mode command. 


ESCAPE ESCAPE 


I 


The editor responds by printing an exclamation point in the 
command portion of the screen; the exclamation point signifies 
that you are using immediate mode. 


Character insertion is the default operation and occurs when¬ 
ever you t 5 ^e a character other than one of the immediate mode 
commands listed in Table 5-2. 


Character Insertion 
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CTRL/G 


CTRL/V 


DELETE 


CTRL/N 


The next several paragraphs demonstrate the use of the imme¬ 
diate mode commands on a selected portion of text. Remember 
that all characters you type that are not immediate mode com¬ 
mands are treated as input. Commands do not echo on the 
graphics screen, so all you ever see is the current text file. Type 
the following: 

TO BEt OR NOT TO BE - THAT IS THE QUESTION:® 

WHETHER 'TIS NOBLER IN THE MIND AND HEART TO SUFFER® 
THE SLINGS OF OUTRAGEOUS FORTUNE® 

OR TO TAKE ARMS AGAINST A SEA OF TROUBLES*® 

AND BY OPPOSING END THEM?® 

As you can see on the graphics screen, the cursor (pointer) is 
positioned at the beginning of a new line. CTRL/G, equivalent 
to -A in standard editing, moves the cursor to the beginning of 
the previous line; the cursor is repositioned immediately. T 5 T)e: 

(CTBL/G I 

CTRL/G I 
CTRL/G 1 

The cursor has moved backward three lines, one line for each 
CTRL/G command, and is positioned before the line: 

THE SLINGS OF OUTRAGEOUS FORTUNE. 

CTRL/V, equivalent to -J, moves the cursor back one character. 
Move the cursor back over the carriage return and line feed at 
the end of the previous line by t 3 Tping the CTRL/V command 
eleven times (remember, the carriage return and line feed 
count as two characters): 

ciRiTvi (eleven [11] times) 

WHETHER 'TIS NOBLER IN THE MIND AND HEART TO SUFFER 

This positions the cursor before the word TO. The command 
DELETE, equivalent to -D, deletes the character immediately 
preceding the cursor. Type the DELETE key ten times: 

® (ten [10] times) 

WHETHER 'TIS NOBLER IN THE MIND TO SUFFER 

CTRL/N, equivalent to A, advances the cursor to the beginning 
of the next line: 

CTRL/N 1 

THE SLINGS OF OUTRAGEOUS FORTUNE. 
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CTRL/D, equivalent to J, moves the cursor forward one charac¬ 
ter; type CTRL/D ten times: 


CTBL/Ol (ten [10] times) 

THE SLINGS OF OUTRAGEOUS FORTUNE* 

Next type this text (it will be inserted immediately to the left of 
the cursor): 


lElANDlPlARROWS 


The text on the screen should now look as follows: 


TO BE OR NOT TO BE - THAT IS THE QUESTION; 
WHETHER 'TIS NOBLER IN THE MIND TO SUFFER 
THE SLINGS AND ARROWS OF OUTRAGEOUS FORTUNE* 
OR TAKE ARMS AGAINST A SEA OF TROUBLES* 

AND BY OPPOSING END THEM? 


Check your results and correct any other mistakes you may 
notice. 

To return to the standard editing command mode, type a single 
ESCAPE. 

gl£l 


This ESCAPE command does not echo on the screen. Notice 
that the exclamation point immediately disappears and the text 
window format returns; an asterisk appears immediately below 
the exclamation point on the screen. 

You use immediate mode only to create and edit text. Opera¬ 
tions that move text in and out of the text buffer must be done 
with standard editing commands. 

You do not need to save the text you have just created, so use 
the CTRL/C command and two ESCAPES to return control di¬ 
rectly to monitor command mode. As mentioned before, EDIT 
requires this unusual command combination to prevent an acci¬ 
dental CTRL/C from killing your text. 

ICTRl/C l (ESC)(ESgl 


Following are two demonstration programs. One is written in 
the FORTRAN IV programming language and one is written in 
the MACRO-11 assembly language. Both programs are used in 
later chapters of this manual, and both contain intentional mis¬ 
spellings and errors. 


CTRL/D 


ESCAPE 


CTRL/C ESCAPE 
ESCAPE 


CREATING THE 
DEMONSTRATION 
PROGRAMS 
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Use the editor to create these programs. Type them exactly as 
they are shown, including errors. Use tabs and spaces to format 
each line as shown (remember that tab stops are positioned 
every eight spaces across the terminal page). Make sure that 
the FORTRAN IV program is formatted properly so that a 
source comparison described in the next chapter will operate 
properly. Except for the comment lines (those beginning with a 
C) and the lines that begin with a number, begin all lines with 
a tab. Use apy of the editing commands described in this 
chapter. Activate the display editor and immediate mode if you 
wish. 

When you have finished, check each file carefully. The two files 
should match those shown here exactly, including tabs and 
spaces. Correct any errors that you find that are not inten¬ 
tional. Obtain a listing of each file by using b (lsc)/L Heidi 
before closing the file. 

Create the FORTRAN IV file first. Call it GRAPH.FOR and use 
the system volume for storage. Then create the MACRO—11 
program. Call it SUM.MAC and again use the system volume 
for storage. 


NOTE 

Knowledge of the FORTRAN IV and MACRO—11 lan¬ 
guages is not necessary to create these demonstration 
programs. 

The following program, GRAPH.FOR, is the FORTRAN IV 
demonstration program. 

C GRAPH.FOR VERSION 1 

C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
C OF AN EXTERNAL FUNCTION* FUN(X*Y) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DATA STATEMENTS 
C ••STAB" IS FILLED WITH A TABLE OF WEIGHT FLAGS 
C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 

SCAL(ZMIN *ZMAX *MAXZ ,K)*ZMIN+FLOAT(K-1)#(ZMAX-ZMIN)/FLOAT(MAXZ-1) 
LOGICAL*! STRING(13*3)tSTABf100) 

DATA XMINtXMAX .MAXX/-5*5*45/ 

DATA YMIN*YMAX*MAXY/-5*5*72/ 

DATA FMIN*FMAX/0.0*1.0/ 

CALL SC0PY('- 12345G78S •►'*STAB) 

MAXFLEN(STAB) 

DO 20 IX*1*MAXX 

X*SCAL(XMIN*XMAX*MAXX*IX) 

CALL REPEAT( ' *STRING*MAXY) 

IFdX.EO.l .OR. IX.EO.MAXX) GOTO 20 
DO 10 IY«2*MAXY-1 

Y*SCAL(YMIN *YMAX *MAXY *IY) 

IFUN*2'HNT(FLOAT(MAXF-3)*(FUN(X *Y)-FMIN)/(FMAX-FMIN)) 
STRING!lY)=STAB(MIN0(MAXF *MAX0(1 *IFUN))) 

CALL PUTSTRING(7*STRING* ' ') 

CALL EXIT 
END 

FUNCTION FUN(X*Y) 

R = S0RT ( X**2-^Y#*2) 

FUN=X*Y*R*EXP(-R))**2 
RETURN 
END 


10 

30 
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The following program, SUM.MAC, is the MACRO-11 demon¬ 
stration program. 


.TITLE SUM.MAC VERSION 1 
•MCflLL .TTYOUT. .EXIT. .PRINT 



z 

II 

o 

;no. 

OF DIGITS OF 'E' TO CALCULATE 

t 

'E' = THE SUM OF THE 

RECIPROCALS OF THE FACTORIALS 

5 

1/0! + 

1/1} + 1/2! + 

1/3! l/a\ + 1/5! + ... 

EXP: 

.PRINT 

•MESSAG 

iPRINT INTRODUCTORY TEXT 


MOO 

«N »R5 

;no. of chars of 'E' to print 

FIRST: 

MOU 

«N+1»R0 

?N0. OF DIGITS OF ACCURACY 


MOO 

«A >R1 

;address of digit vector 

SECOND: 

ASL 

SRI 

;do multiply by lo (decimal) 


MOO 

0R1»-(SP) 

iSAVE *2 


ASL 

SRI 



ASL 

SRI 

;*8 


ADD 

(SP)+ »(R1 ) + 

;N0W ♦lOi POINT TO NEXT DIGIT 


DEC 

RO 

;at end of digits? • 


ONE 

2ND 

;branch if not 


MOV 

»N iRO 

iGO THRU ALL PLACES# DIVIDING 

THIRD: 

MOV 

-(R1)fR3 

;by the places index 


MOV 

• -1 iRZ 

ilNIT QUOTIENT REGISTER 

FOURTH: 

INC 

R2 

iBUMP QUOTIENT 


sue 

RO »R3 

;SUBTRACT LOOP ISN'T BAD 


BCC 

FOURTH 

;numerator is always < io#n 


ADD 

RO iRD 

5FIX REMAINDER 


MOV 

R3 *9Rl 

;SAVE REMAINDER AS BASIS 

;for next digit 


ADD 

R2-2(R1) 

tGREATER INTEGER CARRIES 

;to give digit 


DEC 

RO 

;at end of digit vector? 


DNE 

THIRD 

iBRANCH IF NOT 


MOV 

-(R1)»R0 

;get digit to output 

FIFTH: 

SUB 

•10.»R0 

;FIX the 2.7 TO .7 SO 
iTHAT IT IS ONLY 1 DIGIT 


BCC 

FIFTH 

;(REALLY DIVIDE BY 10) 


ADD 

• 10+ '0 »R0 

iMAKE DIGIT ASC II 


.TTYON 


iOUTPUT THE DIGIT 


CLR 

SRI 

;CLEAR NEXT DIGIT LOCATION 


DEC 

R5 

;more digits to print? 


BNE 

FIRST 

iBRANCH IF YES 


.EXIT 


;WE ARE DONE 

EXP: 

.REPT 

N+1 



.MORD 

.ENDR 

1 

UNIT VECTOR TO ALL ONES 

HESSAG: 

.ASCII 

/THE VALUE OF E IS:/ <15><12> /2./ <200> 


.EVEN 




.ENDEXP 




When you have created and checked these two programs, ob¬ 
tained listings, and stored them as files on your system volume, 
go on to Chapter 6, Comparing Text Files. Chapter 6 demon¬ 
strates a proofreading aid that helps you evaluate yovu* editing 
ability. 


RT-ll System User’s Guide (AA-5279C-TC). Maynard, Maas.: Digital Equip- REFERENCE 

ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 
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CHAPTER 6 
COMPARING TEXT FILES 


The RT-11 operating system provides a proofreading aid, called 
a source comparison, to help you quickly establish the differ¬ 
ences between two ASCII text files. During a source compar¬ 
ison, the system compares the two files, character for character, 
and prints on the terminal (or line printer) any lines that con¬ 
tain differences. 

Usually, you perform a source comparison against two files that 
you expect to be the same, or at least similar. For example, if an 
individual has copied one of your files to make changes to it, 
you can quickly scan the changes by performing a source com¬ 
parison between the new version and yoUr original. Another 
use of a source comparison is to check edits you have made to a 
file yourself. By comparing the backup file against the edited 
version, you can proofread the changes since only the portions 
of text that are different are printed. 

In this chapter, you will use source comparisons to find editing 
errors that may exist in the demonstration programs 
(GRAPH.FOR and SUM.MAC) that you created in Chapter 5. 
These demonstration programs contain intentional misspell¬ 
ings and misplaced text that you must correct before the pro¬ 
grams can be used in later demonstrations. On your system 
volume is a counterpart of each file. These counterparts are 
provided as part of the RT-11 operating system so that you can 
use them to perform a source comparison against your own ver¬ 
sions. Essentially, the counterpart programs have been carried 
one step further in the editing process than your own; they 
contain no editing errors. Therefore, when you compare them 
against your versions, the printed list of differences will reflect 
the t)q)ing errors that still exist in your versions — some of 
these errors are intentional; others you may have inadvertently 
introduced during editing. All must be corrected before you can 
use the programs. 


The monitor command used to compare two text files is the 
DIFFERENCES command. When you type this command on 
the terminal, it activates the RT—11 utility program called 
SRCCOM.SAV, which is part of the RT—11 operating system 
stored on the system volume. The system prompts you for the 
input file names. Respond to the input prompts with the names 
of the files you want to compare; the default storage volume is 
the system volume. The output will be sent to the terminal, 
which is the default device for output. 


PERFORMING A 
COMPARISON 
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DIFFERENCES 


The programs that you created in Chapter 5, SUM.MAC and 
GRAPH.FOR, have their respective counterparts, 
DEMOXl.MAC and DEMOFl.FOR, on the system volume. Use 
the DIFFERENCES command to compare the MACRO-11 
(.MAC) files first. The /MATCH option indicates the number of 
lines that determine a "match”, explained in a moment. ‘ 

Long Command Format 

, DIFFERENCES/MATCH; 1® 

File 1? DEMOXl.MAC® 

File 2? SUM.MAC® 

Short Command Format 

. DIFFERENCES/MATCH;1 DEMOXl.MAC SUM.MAC® 

The list of differences printed on your console terminal should 
be similar to the following example. It will show all the differ¬ 
ences listed here, plus any others that you may have introduced 
yourself during editing. 

Notice the format of the list. Individual sections are marked 
with the letters A, B, C, and D to help you become acquainted 
with the format. A description follows the list, and you should 
refer to it as you study the list. 

A 1) DK:DEM0X1.MAC 
A 2) DK:SUM.MAC 


#*###»#### 


c 

1) 1 

.TITLE 

EXAMP.MAC 

(VERSION PROVIDED) 

D 

1) 

1) 

.MCALL 

.TTYOUT» .EXIT» 

.PRINT 

B 

#### 




C 

2)1 

.TITLE 

SUM.MAC VERSION 

1 


2) 




D 

2) 

.MCALL 

.TTYOUTt .EXIT» 

.PRINT 






C 

1 ) 1 

6NE 

SECOND 

iBRANCH IF NOT 

D 

1 ) 

MOO 

«N »R0 

iGO THRU ALL PLACES 





iDIVIDING 

B 

*«** 




C 

2)1 

5NE 

2ND 

iBRANCH IF NOT 

D 

2) 

MOO 

«N »R0 

iGO THRU ALL PLACES 





iDIVIDING 


«««******« 




C 

1) 1 

ADD 

«10+ "0 iRO 

iMAKE DIGIT ASCII 

D 

1) 

.TTYON 


iOUTPUT THE D-IGIT 

B 





C 

2)1 

ADD 

• 10+ "0 »R0 

iMAKE DIGIT ASC II 

D 

2) 

.TTYON 


iOUTPUT THE DIGIT 


*####*♦##♦ 




C 

1)1 

.END 

EXP 


B 

««#* 




C 

2)1 

.ENDEXP 



*«**««**«* 

?SRCCOM-W-Fi1es are different 


^Users of display hardware may wish to enable both the graphics screen and 
the terminal printer by first typing the CTRL/E command. 
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The first two lines identify the two files thnt are being com¬ 
pared. The file name and the device on which the file resides 
are printed. Also, the numbers 1) and 2) are assigned to the 
files (see lines labeled A in the example list above). 

The first difference that is listed occurs in the title line of the 
program. Usually differences that occur in these two lines are 
intentional and reflect information that is unique to each file, 
such as name and file t 5 q)e, version or edit number, and perhaps 
date of creation. 

The numbers that appear at the left margin of the list further 
identify the files. For example, 1)1 indicates the first page of 
the first file and 2)1 indicates the first page of the second file. 

The lines of both files are compared character for character. 
Blank lines are ignored, but all other characters, including tabs 
and spaces, are compared. When two lines are found to be dif¬ 
ferent, the system prepares a difference section, which it subse¬ 
quently prints (see lines labeled B). 


The system prepares the difference section as follows. When it 
finds two lines that are different, it notes the page number and 
records the lines (see lines labeled C). Next it searches for a 
match. A match is a certain number of lines in each file that 
are exactly the same. Since you specified a match of 1 in the 
/MATCH:n option (/MATCH: 1), the system in this case searches 
for a single line in each file that is exactly the same. When the 
system finds a match, it records the last line of the match for 
identification purposes (see lines labeled D). Then it prints the 
difference section and repeats the process, preparing a subse¬ 
quent difference section if more differences exist. Individual dif¬ 
ference sections are separated from each other by a long row of 
asterisks, while the short rows of asterisks separate the lines of 
the first file from those of the second. 

A message is printed following the comparison. Files are dif¬ 
ferent is printed if differences exist; No differences found is 
printed if the files are the same. 

Check the list printed on your terminal to find the errors the 
system detected. Mark each error on the listing of SUM.MAC 
that you obtained in Chapter 5. 

Now perform a source comparison between the FORTRAN IV 
files, DEMOFl.FOR and GRAPH.FOR. 

Long Command Format 

. DIFFERENCES/MATCH:!® 

File 1? DEMOFl.FOR® 

File 2? GRAPH.FOR® 


DIFFERENCES/ 

MATCHin 
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Short Command Format 

. DIFFERENCES/MATCH: 1 DEM0F1«F0R GRAPH.FOR® 


1) DK:DEMOFl.FOR 

2) DKiGRAPH.FOR 

«««*«*«*«* 

l)l C EXAMP.FOR (VERSION PROVIDED) 

1) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 

#**# 

2) 1 C GRAPH.FOR VERSION 1 

2) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 

********** 

1)1 C "STAB” IS FILLED WITH A TABLE OF HEIGHT FLAGS 

1) C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 

#*#* 

2) 1 C "STAB" IS FILLED WITH A TABLE OF WEIGHT FLAGS 

2) C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 


********** 

1)1 MAXF=LEN(STAB) 

1) DO 20 IX=1 .MAXX 


«*** 

2)1 MAXFLEN(STAB) 

2) DO 20 IX=1»MAXX 


********** 

1) 1 30 

1 ) 

*«** 

2) 1 30 

2 ) 

********** 

?SRCCOM-W-Files 


CALL PUTSTR(7»STRING»' M 
CALL EXIT 

CALL PUTSTRING(7 .STRING»^ 
CALL EXIT 

are diffe rent 


') 


Similarly, mark the errors on the listing of GRAPH.FOR that 
you obtained in Chapter 5. 

Now return to the section entitled Editing a Text File in 
Chapter 5. Review the editing commands described there and 
the summary at the end of the section. Use the appropriate 
commands to correct the files SUM.MAC and GRAPH.FOR. 
When you have finished editing, perform the source compari¬ 
sons again against DEMOXl.MAC and DEMOFl.FOR. If you 
have edited the files correctly, the comparison finds differences 
only between the first lines of each program. The following 
messages should print on your console; 


.DIFFERENCES/MATCH: 1® 
File 1? DEMOFl.FOR® 
File 2? GRAPH.FOR® 

1) DK:DEM0F1.FOR 

2) DK:GRAPH.FOR 


1)1 C EXAMP.FOR (VERSION PROVIDED 

1) C THIS PROGRAM PRODUCES A PLOT ON 
•*■**•* 

2) 1 C GRAPH.FOR VERSION 1 

2) C THIS PROGRAM PRODUCES A PLOT ON 

?SRCCOM-W-Files are different 


THE TERMINAL 


THE TERMINAL 


e-A 


and 
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. DIFFERENCES/MATCH:!® 
File 1? DEMOXl^MAC® 
File 2? SUM*MAC® 

1) DK:DEMOXl•MAC 

2) DK:SUM*MAC 


1 ) 1 
1 ) 

1 ) 

2)1 

2 ) 

2 ) 

***#*#■»#*# 
?SRCCOM-W-Fi les 


♦TITLE EXAMP»MAC (VERSION PROVIDED) 
♦MCALL ♦TTYOUT» ♦EXITt ♦PRINT 
♦TITLE SUM^MAC VERSION 1 
♦MCALL ♦TTYOUTf ♦EXIT^ ♦PRINT 
are different 


These messages indicate that a difference exists in the first line 
of each program. However, no other differences were found in 
the programs during the comparison. Thus, your programs are 
ready for use in later demonstrations, and you know how to 
create and edit programs. 

If differences still exist in your files and you cannot resolve 
them by editing, you may continue to the next chapter if you 
wish. However, you need practice editing, and it is to your ad¬ 
vantage to rework the examples in both Chapter 5 and this 
chapter. 


DIFFERENCES 

List the differences between two ASCII text files. 
DIFFERENCES/MATCHm 

Indicate the number of lines (n) to determine a match; the 
default number is 3. 


RT-ll System Usefs Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT—11 operating system. 

RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-ll system utilities. 
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CHAPTER 7 

PERFORMING FILE MAINTENANCE OPERATIONS 


The system volume, as it is initially supplied, contains only the 
files of the RT-11 operating system — the monitor files, the 
system device handlers, the system utility programs, and per¬ 
haps the language processors. Since the system volume serves 
as the default storage volume for all system operations (unless 
DK: was assigned to another volume), you will discover that it 
acquires many additional files during normal use. For example, 
files that you create with the editor are written on the system 
volume; edited files automatically create backup versions on 
the system volume; many utility programs create output and 
listing files on the system volume as part of their normal pro¬ 
cessing operations. By the time you finish an average session of 
computer operations, several new file names have been added 
to the directory of your system volume. Eventually your system 
volume may become full and its directory cluttered with the 
names of files for which you have no use. To avoid this you 
should perform regular housekeeping, or file maintenance, op¬ 
erations as you use the system. You should update and transfer 
copies of your important files to other storage volumes for safe¬ 
keeping and later use, and you should delete from your system 
and storage volume directories the names of files you no longer 
need. 

The RT-11 operating system provides a number of monitor 
commands for this purpose. These commands activate the 
RT-11 utility programs called PIP.SAV, DUP.SAV, and 
DIR.SAV, which are part of the RT-11 operating system stored 
on your system volume. These utility programs allow you to 
transfer and erase files. The commands used in this chapter 
show one way to maintain your system and storage volume. 
When you become more familiar with system operations and 
learn some of the commands not described here, you may prefer 
other methods. 


Before you perform operations that might move or erase files on 
a volume, list a directory of the volume involved. The directory 
tells you the full names of files, their sizes, and whether backup 
copies exist. A directory of your system volume shows the files 
that have been added to it through normal use. 

First obtain a directory of your system volume (as you learned 
in Chapter 4), using the appropriate command to list it on ei¬ 
ther the terminal or the line printer. The directory is relatively 
long; let it list to completion. 


FILE DIRECTORY 
OPERATIONS 
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MULTIPLE FILE 
OPERATIONS 


Long and Short Command Format 
(Line printer) 


• DIRECTORY/PRINTER® 
(Terminal) 


•directory® 

At the end of the system volume directory you should see sev¬ 
eral additional entries. These files are the result of the system 
operations you have performed so far: 


DECIND.USA 

1 

8-JAN-83 

DECIND.BAK 

1 

8-JAN-83 

GRAPH 

♦ FOR 

2 

8-JAN-83 

GRAPH 

♦ BAK 

2 

8-JAN-83 

SUM 

♦ MAC' 

3 

8-JAN-83 

SUM 

♦ BAK 

3 

8-JAN-83 

Next list a brief directory 

of your storage volume. This direc- 


tory should be empty (void of any file names or file types) be¬ 
cause you initialized it in Chapter 4. 


Long and Short Command Format 
(Line printer) 


‘directory/BRIEF/PR inter UOL:® 

(Terminal) 

'directory/brief UOL:® 

These directories give you the information you need for erasing 
and copying files. For example, you know the additional files 
that are now on your system volume, and you know that since 
the directory of the storage volume is empty, there is ample 
room on it for new files. 


You often have occasion to perform the same utility operation 
on several files. For example, you may copy from one volume to 
another all files with the file type .MAC, or you may erase from 
a volume all files with the name TEST. Rather than perform 
the required operation on the files one at a time, it is easier to 
use the wildcard construction, a shorthand method provided by 
the RT-11 operating system. Wildcard construction allows you 
to substitute an asterisk (*) or percent sign (%) for a portion of 
the file name that is variable among all the files you want used 
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in the operation. For example, specifying DECIND.* in a com¬ 
mand causes the operation to act on all files with the file name 
DECIND, regardless of their file t 3 T)e; *.BAK causes the system 
to act on files with the file type BAK, regardless of their file 
name. Specifying TEST%.FOR causes the operation to act on all 
files having a t 5 T)e of FOR, starting with the four characters 
TEST, and having any fifth character (for example, 
TESTA.FOR, TESTl.FOR, etc.). 

A special use of the wildcard construction involves substitution 
of an asterisk for both file name and file type. *.* implies that 
all files, regardless of the file name or file type, are to be used 
in the operation. 

Exercises in this chapter and throughout the remainder of the 
manual demonstrate various uses of the wildcard construction. 


FILE COPYING 
OPERATIONS 


COPY 


name GRAPH.TWO, type: 

Long Command Format 

• COPY® 

From? graph.FOR® (System volume is 

To ? ooL:GRAPH, TWO® assumed for input.) 

Short Command Format 

. COPY GRAPH.FOR VOL : GR A PH . TWO® 

The system makes a copy of the file GRAPH.FOR on the stor¬ 
age volume and gives the copy the name GRAPH.TWO. When 
the operation is complete, the monitor prints a period at the left 
margin and waits for you to enter the next command. This 
time, copy SUM.MAC to the storage volume. 


Storage volumes provide an area where you can store important 
files. Since most files are originally created on the default sys¬ 
tem volume, you must copy them from the system volume to the 
storage volume. The following exercises show you how to make 
backup copies on your storage volume of the two provided dem¬ 
onstration programs (DEMOFl.FOR and DEMOXl.MAC), and 
how to copy to the storage volume the two programs you cre¬ 
ated (GRAPH.FOR and SUM.MAC). 

The monitor command that copies files between volumes is the 
COPY command. This command instructs the system to dupli¬ 
cate the file that you indicate as input, and then gives the new 
file the name and file type that you specify as output. The origi¬ 
nal version of the file is unaffected; that is, a copy of the origi¬ 
nal version is made and moved to the new volume. 

To copy GRAPH.FOR to your storage volume under the new 
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FILE RENAMING 
OPERATIONS 


Long Command Format 

• COPY® 

Front? SUM.MAC® 

To ? UOLrSUM.MAC® 

Short Command Format 

•COPY SUM.MAC UOL:SUM.MAC® 

The system copies the file SUM.MAC to your storage volume 
and gives the copy the name SUM.MAC. 

Now, copy the two provided demonstration programs, 
DEMOFl.FOR and DEMOX1.MA.C, to the storage volume. 


Long Command Format 

•COPY® 

F row? dEMOFI .FOR® 

To ? U0L:DEM0F1 .FOR® 

•COPY® 

F row? dEMOXI .MAC® 

To ? UOL: DEMOXI .MAC® 


Short Command Format 

•COPY DEMOFl.FOR UOL : DEMOF 1 . FOR® 
•COPY DEMOXI.MAC UOL ; DEMOX1 . MAC® 


A directory of your storage volume should verify that it now 
contains these four files. ^ 

Long and Short Command Format 

•DIRECTORY MOL:® 

08-Jan-83 

GRAPH *TWG 2 08-Jan-83 SUM .MAC 3 08-Jan-83 

DEMOFl.FOR 2 2G-Au^-82 DEMOXI.MAC 3 2B-Au^-82 

4 Files# 10 BlocKs 
4752 Free blocks 


The directory you just listed shows that you copied the GRAPH 
demonstration file to your storage volume under a new file 
type, .TWO. Assume you did not intend to copy it using a new 
file type and now wish that it were assigned its original file 


you are using magtape as your storage volume, read the section entitled 
Directory vs Nondirectory-Structured Volumes in Appendix B. 
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type, .FOR. Use the monitor RENAME command to rename the 
file already on the storage volume.* 

Long Command Format 

• RENAME® 

From? OOL:GRAPH.TWO® 

To ? OOLrGRAPH.FOR® 

Short Command Format 

. RENAME VOL:GRAPH.TWO OOL :GRAPH. FOR® 

The RENAME command simply changes the file name or file 
type of a file in the volume directory without altering or mov¬ 
ing the file itself. When you perform a rename operation, the 
volume indicated in the input and output portions of the com¬ 
mand must be the same; otherwise a system message is printed. 

Rename the file copies DEMOXl.MAC and DEMOFl.FOR 
presently on your storage volume to EXAMP.MAC and EX- 
AMP.FOR respectively. 

• RENAME yOL:DEMOXl .MAC VOL; EXAMP . MAC® 

. RENAME VOLrOEMOFl .FOR VOL : EXAMP. FOR® 

Again list a directory of your storage volume to verify that the 
renaming operation occurred. 

Long and Short Command Format 

• DIRECTORY VOL:® 

08-Jan-83 

GRAPH.FOR 2 08-Jan-83 SUM .MAC 3 08-Jan-83 

EXAMP.FOR 2 2G-AuS-82 EXAMP.MAC 3 2G-AuS-82 

4 Files^ 10 Blocks 
4752 Freeblocks 


Once copies of your important files are stored on a storage vol¬ 
ume, you can delete from the system volume — or any other 
volume — those files that you no longer need. The file deletion 
operation removes information about the file from the volume’s 
directory; the space that the file occupies on the volume be¬ 
comes available for reuse. Files that you want to delete gener¬ 
ally include .BAK files created during editing, temporary files 
created by utility programs, or any other unnecessary files. 

^Magtape users cannot use the RENAME command and should read the sec¬ 
tion entitled Alternate Rename Operation for Magtape Users in Appendix B. 


RENAME 


FILE DELETION 
OPERATIONS 
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DELETE 


Now that you have copies of your important files, you can de¬ 
lete several files from your system volume. For example, you 
can delete all files with a .BAK file type created as a result of 
editing. You can delete the file DECIND.USA, since this was 
created only for editing practice. Finally, you can delete the 
files GRAPH.FOR and SUM.MAC, since copies of these are now 
on VOL:. 

Do not delete DEMOFl.FOR and DEMOXl.MAC from your 
system volume, even though copies of these are also on VOL:. 
You should consider these two files as part of the RT-11 opera¬ 
ting system, and therefore should not erase them from the sys¬ 
tem volume. These copies can serve as additional backups for 
the files on the storage volume. 

The monitor DELETE command is used to delete file names 
from a volume. You can specify as many as six input files for 
deletion. 

Long Command Format 
♦ DELETE® 

Files? DECIND.USA .GRAPH.FOR .SUM.MAC® 

Short Command Format 

. DELETE DECIND.USA .GRAPH.FOR .SUM.MAC® 


If wildcard construction is used or if the /QUERY option is spec¬ 
ified, the DELETE command requests confirmation from you by 
printing each file name on the terminal before it deletes it. If 
you type a Y response, the system deletes the file, while an N 
response instructs the system to ignore that file and go on to 
the next. Notice how you use the wildcard construction in the 
input file to delete all files with a .BAK file type. 


Long Command Format 


• DELETE® 

Files? #.BAK® 

Files deleted: 
DKrDECIND.BAK ? Y® 
DK:SUM,BAK ? Y® 
DK:GRAPH.BAK ? Y® 


» DELETE/OUERY® 

Files? GRAPH. BAK tSUM.BAK iDECIND.BAK® 
Files deleted: 

DK :DECIND.BAK ? Y® 

DK:SUM.BAK ? Y® 

DK:GRAPH.BAK ? Y® 


Short Command Format 


• DELETE *.BAK® 
Files deleted: 
DK:DECIND.BAK ? Y® 
DK:SUM.BAK ? Y® 
DK:GRAPH.BAK ? Y® 


* DELETE/OUERY GRAPH.BAK »SUM.BAK #DECIND.BAK® 
Files deleted: 

DK:DECIND.BAK ? Y® 

DK:SUM.BAK ? Y® 

DK:GRAPH.BAK ? Y® 
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You can give a file a protected status to prevent it from being 
deleted from the volume it resides on. A file that has a pro¬ 
tected status cannot be deleted until that status is removed. 

The files DEMOFl.FOR and DEMOXl.MAC should still be on 
your system volume. These files must not be deleted because 
they are part of your RT-11 operating system. You can give 
these two files a protected status to ensure that they are not 
accidentally deleted. 

The monitor PROTECT command is used to give files a pro¬ 
tected status. You can specify up to six input files (separated 
with commas) with this command. As with the DELETE com¬ 
mand, if you use the wildcard construction or specify the 
/QUERY option, the RT-11 system requests confirmation be¬ 
fore protecting each file. 

Use the PROTECT command to give the files DEMOFl.FOR 
and DEMOXl.MAC a protected status. 

Long Command Format 

. PROTECTU!) 

Files? DEMOFl .FOR (DEMOXl .MAC® 

Short Command Format 

. PROTECT DEMOFl .FOR (DEMOXl .MAC® 

List a directory of these two files and notice the "P” next to the 
number of blocks in the second column. 

Long and Short Command Format 

. DIRECTORY DEMOFl.FOR .DEMOXl.MAC® 

08-Jan-83 

DEMOXleMAC 3P 2B-Au^-82 DEM0F1*F0R 2P 2G-AuS-82 
2 Files# 5 Blocks 
921 Free blocks 

The UNPROTECT command removes a file’s protected status 
so that the file can be deleted. You can determine whether a file 
is protected or not by listing the directory. If a file is protected, 
a "P” will appear next to the block size number of the file’s 
directory entry. You can specify up to six input files (separated 
with commas) with this command. As with the DELETE com¬ 
mand, if wildcard construction is used or if the /QUERY option 
is specified the UNPROTECT command requests confirmation 
for each file. 

Remove the protected status from the files DEMOFl.FOR and 
DEMOXl.MAC. 


FILE PROTECTION 
OPERATIONS 


PROTECT 


UNPROTECT 
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Long Command Format 

. UNPROTECT® 

Files? DEMOFl .FOR fOEMOXl .MAC® 


Short Command Format 

. UNPROTECT DEMOFl .FOR .DEMOXl .MAC® 


Again list a directory of the two files DEMOFl.FOR and DEM- 
OXl.MAC. The "P” ’s are removed from the listing, signifying 
that the files are no longer protected. 


Long and Short Command Formats 

, DIRECTORY DEMOF 1 . FOR »DEMOX 1 . MAC® 

08-Jan-83 

DEMDXl.MAC 3 26-Au^-82 DEMOFKFOR 

2 Files » 5 BlocKs 
921 Free blocKs 


2G-Autf-82 


FILE LISTING 
OPERATIONS 


PRINT 


TYPE 


You sometimes need a listing of a file before you can decide 
whether or not to delete it. In Chapter 5, you used the RT-11 
editor to get listings of the files you created. You can also use 
monitor commands to obtain listings of files. One command 
lists a file on the console terminal; another lists a file on the 
line printer.' The system volume is the assumed storage volume 
for the input file. 


Type one of the following sets of commands to obtain listings of 
EXAMP.MAC and EXAMP.FOR. 


Long Conunand Format 
(Line Printer) 

. PRINT® 

Files? UOL:EXAMP.MAC® 

. PRINT® 

Files? 00L:EXAMP.F0R® 

Short Command Format 
(Line Printer) 

. PRINT UOL:EXAMP.MAC® 

. PRINT U0L:EXAMP.F0R® 


(Terminal) 

..TYPE® 

Files? VOL: EXAMP.MAC® 
. TYPE® 

Files? VOL:EXAMP.FOR® 


(Terminal) 

. TYPE VOLzEXAMP.MAC® 
.■TYPE V0L:EXAMP.F0R® 


a line printer is available on your system, you should always use it for 
listings because of its high speed of printing. 
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You should perform file maintenance operations periodically as 
you use the system. File maintenance keeps your system and 
storage volumes up-to-date and provides m axim um free space 
on volumes for new files. 


COPY 

Copy the specified file from one volume to another. 

DELETE 

Delete the specified file(s) from the volume’s directory. Con¬ 
firmation is required before deleting the file if wildcard con¬ 
struction or the /QUERY option is used. 

DIRECTORY 

List the volume directory on the terminal. 

DIRECTORY/PRINTER 
List the volume directory on the line printer. 

PRINT 

List the contents of the specified file on the line printer. 
PROTECT 

Give the specified file protected status so it cannot be deleted 
until that status is removed. Confirmation is required before 
protecting the file if wildcard construction or the /QUERY 
option is used. 

RENAME 

Give a new name to the specified file. 

TYPE 

List the contents of the specified file on the terminal. 
UNPROTECT 

Remove the protected status of the specified file so that the 
file can be deleted. Confirmation is required before removing 
each file’s protection if wildcard construction or the /QUERY 
option is used. 


RT-ll System User^s Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 


SUMMARY: 
FILE MAINTENANCE 
COMMANDS 


REFERENCE 
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CHAPTER 8 

CHOOSING A PROGRAMMING LANGUAGE 


Programming languages and language processors are aids pro¬ 
vided by the operating system to help you develop programs of 
your own. Whenever you plan to write a program, you must 
first decide on the programming language that you will use, 
since most computer systems support several. After you have 
chosen the language, you must design and code your program 
using appropriate language statements and being careful to 
follow formatting rules and restrictions. Finally, you must use 
tte corresponding language processes, which is stored on the 
system volume or on a volume of its own, to convert your pro¬ 
gram statements into a format suitable for execution. 


Hundreds of programming languages have been developed for 
computer systems. Some languages can be used only for specific 
applications or with a particular computer system. Other lan¬ 
guages are general purpose; they are suitable for a variety of 
problem-solving situations and, in addition, are easy to learn 
and use. The languages demonstrated in this manual include 
two well-known and widely used high-level programming lan¬ 
guages (BASIC-11 and FORTRAN IV) and one RT-11 system- 
specific machine-level programming language (MACRO-11). 

High-level languages, like BASIC—11 and FORTRAN IV, are 
usually easy to learn and use. You write programs using lan¬ 
guage statements that need not deal with the specifics of the 
computer system. The language processor — and perhaps 
other utility programs as well — handles all conversions that 
are necessary for program execution. Since a single high-level 
language statement may perform several computer operations, 
and since you need not be concerned or familiar with the struc¬ 
ture of the computer and peripheral devices, you can concen¬ 
trate solely on solving the problem at hand. The language proc¬ 
essor takes care of translating the statements into computer 
information. 

Thus, high-level languages are considered machine-inde¬ 
pendent languages because language statements are such that 
any program written in the language can usually be executed 
on an entirely different computer system (that supports the lan¬ 
guage) with few, if any, modifications. 

Machine-level languages, on the other hand, such as the as¬ 
sembly language MACRO-11, require that you know about the 
computer and the peripheral devices and how they work to¬ 
gether. You write programs in formats that are closer to those 


HIGH-LEVEL VS 
MACHINE-LEVEL 
LANGUAGES 
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required for execution. Since a single machine-level language 
statement usually performs only one computer operation, you 
must account in your program for each computer operation that 
will be required. 


For this reason, machine-level languages are machine- 
dependent languages. The program is coded in a format that is 
not usually interchangeable among systems. Machine-level lan¬ 
guage programs can be efficient because the knowledgeable 
programmer will choose the fastest and most precise instruc¬ 
tions for getting a job done. 

Table 8-1 lists a comparison of high-level vs machine-level lan¬ 
guages. 


Table 8-1 Language Comparisons 


High-Level 


Machine-Level 


Easy to learn and use; no 
experience required 

Machine-independent 

Many hidden conversions 
necessary for program exe¬ 
cution; more computer 
memory is used 

Slower execution time 

Less efficient; the system 
makes decisions concerning 
computer operations 

Easier to debug (find and fix 
errors) 

Easier to understand pro¬ 
grams; functions added with 
less difficulty 


More difficult to learn and 
use; familiarity with the com¬ 
puter system required 

Machine-dependent 

Only direct translation is nec¬ 
essary for program execution; 
less computer memory is used 

Faster execution time 

More efficient; the program¬ 
mer makes decisions concern¬ 
ing computer operations 

Harder to debug (find and fix 
errors) 

Harder to understand pro¬ 
grams; functions added with 
greater difficulty 


Beginning programmers, students, commercial applications 
programmers, and the casual computer user prefer high-level 
languages because they are less difficult to learn and to use, 
and they produce fast results. System programmers, on the 
other hand, may prefer machine-level languages for writing 
programs (those that make up an operating system, for exam¬ 
ple) that must often be as fast, efficient, and concise as possible. 










Performing File Maintenance Operations 


You should perform file maintenance operations periodically as 
you use the system. File maintenance keeps your system and 
storage volumes up-to-date and provides maximum free space 
on volumes for new files. 


COPY 

Copy the specified file from one volume to another. 

DFLF'PF 

Delete the specified file(s) from the volume’s directory. Con¬ 
firmation is required before deleting the file if wildcard con¬ 
struction or the /QUERY option is used. 

DIRECTORY 

List the volume directory on the terminal. 

DIRECTORY/PRINTER 
List the volume directory on the line printer. 

PRINT 

List the contents of the specified file on the line printer. 
PROTECT 

Give the specified file protected status so it cannot be deleted 
until that status is removed. Confirmation is required before 
protecting the file if wildcard construction or the /QUERY 
option is used. 

RENAME 

Give a new name to the specified file. 

TYPE 

List the contents of the specified file on the terminal. 
UNPROTECT 

Remove the protected status of the specified file so that the 
file can be deleted. Confirmation is required before removing 
each file’s protection if wildcard construction or the /QUERY 
option is used. 


RT—ll System User's Guide (AA-5279C—TC). Ma3aiard, Mass.: Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT-11 operating system. 
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FILE MAINTENANCE 
COMMANDS 


REFERENCE 


7-9 









CHAPTER 9 

RUNNING A FORTRAN IV PROGRAM 


The FORTRAN IV programming language' is a machine-inde¬ 
pendent programming language that was originally designed 
as a quick and easy aid for solving mathematical equations and 
formulas. However, FORTRAN IV is a powerful language and 
not difficult to learn or use, and is also well suited to many 
other kinds of applications. 


FORTRAN (FORmula TRANslation) IV is an algebraically ori¬ 
ented language. You write a FORTRAN IV program as a se¬ 
quence of language statements that combine common English 
words with quasi-algebraic formulas. You then arrange groups 
of the language statements into logical units called program 
units. One or more program units make up an entire executable 
FORTRAN IV source program. 

When you are satisfied with the logic of your FORTRAN IV 
source program, you use the RT-11 editor to create it as a file 
(see Chapter 5). You use tabs and spaces to format each line 
properly, and you may choose to insert comment statements 
throughout the source code to explain what various parts of the 
program are doing. When you have finished creating the pro¬ 
gram as a complete, edited file, you next enter it as input to the 
FORTRAN IV language processor, which is stored on your sys¬ 
tem volume or on a separate volume of its own. The FORTRAN 
IV language processor processes (compiles) the language state¬ 
ments, converting them into internal machine-language code 
called object code. This code is next processed by the system 
linker, which combines your program units and necessary sys¬ 
tem-supplied routines to make your program suitable for execu¬ 
tion. The development of an executable FORTRAN IV program 
is represented in Figure 9-1. 


DEVELOPING AN 
EXECUTABLE 
FORTRAN IV 
PROGRAM 



Figure 9-1 Evolution of a FORTRAN IV Program 


The FORTRAN IV language processor is a compiler that trans¬ 
lates your source program into a machine language program. 


'The PDP-11 FORTRAN IV programming language conforms to the specifi¬ 
cations for American National Standard FORTRAN X3.9-1966. 


USING THE 
FORTRAN IV 
LANGUAGE 
PROCESSOR 
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USING LIBRARY 
MODULES 


Since you create a FORTRAN IV source program in ASCII for¬ 
mat, you must next translate the program into a machine for¬ 
mat that the computer can use. The FORTRAN IV compiler 
performs the translation, producing as output a new version of 
the program, called an object module. You may instruct the 
FORTRAN IV compiler to produce a listing of the source pro¬ 
gram at the same time. Figure 9-2 is a diagram of the com¬ 
piler’s function. 



Figure 9-2 Function of a FORTRAN IV Compiler 


Typical FORTRAN IV programs often require similar opera¬ 
tions. Most programs, for example, use routines and instruc¬ 
tions that calculate square roots, exponentials, and other arith¬ 
metic functions; handle input and output operations; detect cer¬ 
tain kinds of error conditions; test values; calculate subscripts; 
and perform conversions. These commonly used operations 
have been gathered into a special file called SYSLIB.OBJ (de¬ 
fault System Library), which is provided with the RT-11 opera¬ 
ting system and is stored on your system volume. 

During the processing of your source program, the FORTRAN 
IV compiler examines each language statement in the program. 
If you use operations that are provided in SYSLIB, the compiler 
notes them and makes references to SYSLIB. The compiler 
translates all the information gathered during processing (your 
converted language statements and the references to SYSLIB) 
into numerical data called object code that the system linker 
can use. The result of the compilation, therefore, is an object 
format file, called an object module, which is automatically 
joined with SYSLIB (containing many object modules) and with 
any other required object modules at link time. Linking all the 
necessary object modules together produces a complete, work¬ 
able FORTRAN IV program. 

The FORTRAN IV object time system (OTS) is also needed to 
successfully compile a FORTRAN IV program; this system is in 
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the file FORLIB.OBJ. Whether this file is included in SYSLIB 
or not depends on how your system was built. 

To link the example FORTRAN IV program, you must either 
include FORLIB.OBJ in SYSLIB, or specify SYSLIB before 
FORLIB in the link command. For instructions on how to in¬ 
clude FORLIB in SYSLIB, refer to Section 3.4 in the RT—11 
FORTRAN rV Installation Guide. 


In Chapter 5 you used the RT-11 editor to create a FORTRAN 
IV source program, which you then stored on your storage vol¬ 
ume. Since a source program is in ASCII format, the next step 
is to use the FORTRAN IV compiler to convert it to object code. 

Some RT-11 systems store the FORTRAN IV compiler on a 
volume apart from the system volume. ‘ You can quickly deter¬ 
mine whether the FORTRAN IV compiler is on your system 
volume by using the DIRECTORY command. 

• DIRECTORY SY:FORTRA.SAOdll 

In the directory listing that results, if the directory entry for 
FORTRA.SAV is included, then the required FORTRAN IV 
files are on your system volume. If, however, FORTRA.SAV did 
not appear in the directory listing, then the required files are 
not part of your system volume. Before you can use the com¬ 
piler, you must make a volume substitution. Read the section in 
Appendix B entitled Using the FORTRAN/BASIC Language 
Volume. 

The next step involves using the monitor COPY command to 
copy the FORTRAN IV source program from the storage vol¬ 
ume (where you stored it in Chapter 7) back to the system 
volume, which serves as the default volume for input/output 
operations. 

Remember that on your storage volume are two FORTRAN IV 
source programs, the one you created (GRAPH.FOR) and the 
one provided as part of the system (EXAMP.FOR). Which of 
these you should use depends on the results of the source com¬ 
parison you performed in Chapter 6. If the comparison resulted 
in no differences except for the title lines, copy your own pro¬ 
gram (GRAPH.FOR) as follows: 

Long Command Format 

♦ COPY® 

From? voLrGRAPH.FOR® 

To ? GRAPH.FOR® 


COMPILING THE 
FORTRAN IV 
PROGRAM 


^This is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the FORTRAN IV system files. RXOl diskette is an 
example. 
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FORTRAN 


Short Command Format 
, COPY VOL;GRAPH.FOR GRAPH.FOR® 

However, if differences were printed in addition to the title 
lines, use the provided program (EXAMP.FOR) instead, copy¬ 
ing it under the new name GRAPH.FOR: 

Long Command Format 

. COPY® 

From? VOLrEXAMP.FOR® 

To ? GRAPH.FOR® 

Short Command Format 

. COPY OOLiEXAMP.FOR GRAPH.FOR® 

The FORTRAN IV source file now resides on your system vol¬ 
ume under the name GRAPH.FOR and is the file that you will 
process with the FORTRAN IV compiler. The command used to 
compile a FORTRAN IV source program is the monitor FOR¬ 
TRAN command. 

Use the FORTRAN command with its /LIST option to compile 
your program and produce a listing. The system prompt asks 
you to supply the input file name. You can omit typing the 
.FOR file type since the FORTRAN command assumes this file 
type unless you indicate otherwise. The system will assign the 
name GRAPH.OBJ to the object module and GRAPH.LST to 
the listing file and store both newly created files on your sys¬ 
tem volume, which is the default storage volume for input/out¬ 
put operations. 

Long Command Format 

. FORTRAN® 

Files? GRAPH/LIST® 

Short Command Format 

. FORTRAN GRAPH/LIST® 

Compilation begins. If the compiler discovers an error during 
processing, it prints a message. In this particular case, you 
should see the following on your terminal printer or screen: 

.MAIN. 

7F0RTRAN-I-C .MAIN. ] Errors: 5» WarninSs: 0 
FUN 

7F0RTRAN-1-CFUN 1 Errors: 1. WarninSs: 0 

This indicates that, during processing, the FORTRAN IV com¬ 
piler found six errors in the source program. It helps at this 
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point to look at the listing produced by the compiler, because 
more information is shown there. Print the listing on either the 
line printer or terminal, using one of the following commands: 


Long Command Format 
(Line printer) 

. PRINT® 

Files? GRAPH.LST® 

Short Command Format 
(Line printer) 

. PRINT GRAPH.LST® 


(Terminal) 

. TYPE® 

Files? GRAPH.LST® 


(Terminal) 

. TYPE GRAPH.LST® 


Your listing should look like the following example. 

NOTE 

You do not need to understand the FORTRAN IV lan¬ 
guage or the way this program works to successfully 
complete the exercises in this chapter. 


FORTRAN IV 


V02.5 Sat 08-Jan-83 15;52;0A 


PAGE 001 


C GRAPH.FDR VERSION 1 

C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
C OF AN EXTERNAL FUNCTI0N» FUN(X.Y) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DATA STATEMENTS 
C "STAB" IS FILLED WITH A TABLE OF HEIGHT FLAGS 
C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 
0001 SCAL (ZMIN fZMAX »MAXZ »K)=ZMIN + FLOAT(K- 1)*(ZMAX-ZMIN)/FLOAT(MAXZ-1 ) 

0002 LOGICAL*! STRING(13 .3) »STAB(100) 

0003 DATA XMIN»XMAX>MAXX/-5»5»d5/ 

OOOa DATA YMINfYMAX»MAXY/-5.5»72/ 

0005 DATA FMIN»FMAX/0.0»1.0/ 

OOOS CALL SC0PY('- 123458788 ♦'»STAB) 

0007 MAXF=LEN(STAB) 

0008 DO 20 IX=1,MAXX 

0008 X = SCAL(XMIN»XMAX .MAXX»IX) 

0010 CALL REPEAT! .STRING .MAXY) 

0011 IFdX.EO.l .OR. IX.EO.MAXX) GOTO 20 

0013 DO 10 IY=2.MAXY-1 

0014 Y = SCAL(YMIN .YMAX .MAXY .lY) 

0015 IFUN = 2+INT(FL0AT(MAXF-3)*(FUN(X .Y)-FMIN)/(FMAX-FMIN)) 

0016 10 STRING!IY)=STAB!MI NO!MAXF .MAXO!1 .IFUN) ) ) 

0017 30 CALL PUTSTR!7 .STRING . ' ') 

0018 CALL EXIT 

0018 END 

FORTRAN IV Diagnostics for Prosram Unit .MAIN. 

In line 0003. Error: Modes of variable "XMIN" and data item differ 

In line 0004. Error: Modes of variable "YMIN" and data item differ 

In line 0008. Error: Reference to undefined statement label 

In line 0012. Error: Reference to undefined statement label 

In line 0018. Error: Wrons number of subscripts for array "STRING" 

FORTRAN IV StoraSe Map for P,roSram Unit .MAIN. 

Local Variables. .PSECT $DATA. Size = 000334 ! 110. words) 


Name 

Type 

Offset 

Name 

Type 

Offset 

Name 

Type 

Offset 

FMAX 

R»4 

000230 

FMIN 

R*4 

000224 

IFUN 

1*2 

000312 

IX 

1*2 

000274 

lY 

1*2 

000300 

K 

1*2 

000256 

MAXF 

1*2 

000260 

MAXX 

1*2 

000272 

MAXY 

1*2 

000276 

MAXZ 

1*2 

000254 

MAXO 

1*2 

000316 

MI NO 

1*2 

000314 
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X 

R*d 

000262 

XMAX 

R*4 

000266 

XMIN 

R*4 

000214 

Y 

R*d 

000302 

YMAX 

R*4 

000306 

YMIN 

R«4 

000220 

2MAX 

R#d 

000250 

ZMIN 

R*4 

000244 





Local and COMMON Arrays: 

Name Type Section Offset -Size-Dimensions 

STAB Lai $DATA 0000A7 OOOIAA ( 50.) ;i00) 

STRING L*1 Oec iOATA 000000 0000A7 ( 20.) (13f3) 


Subroutines# Functions# Statement and Processor-Defined Functions: 


Name 

Type 

Name Type Name 

Type 

Name 

EXIT 

R*4 

FLOAT R*4 FUN 

R#4 

INT 

PUTSTR 

R#4 

REPEAT R*4 SCAL 

R*4 

SCOPY 

FORTRAN 

IV 

V02.5 Sat 08-Jan-83 

15:52:07 

PAGE 001 

0001 


FUNCTION FUN(X #Y) 



0002 


R=S0RT(X**2+Y**2) 



0003 


FUN=X*Y*R*EXP(-R))**2 



##*#♦ P 





0004 


RETURN 



0005 


END 



FORTRAN 

IV 

Diainostics for Prosram 

Unit FUN 



Name Type 

LEN 1*2 


In line 0003# Error: CSee source listinj] 
FORTRAN 10 Storage Map for Program Unit FUN 


Local Variables# .PSECT $DATA# Size = 000020 ( 8. words) 


Name 

Type 

Offset 

Name 

Type 

Offset 

Name 

Type 

Offset 

FUN 

Y 

R*4 

R*4 9 

000004 E«^v 

000002 

R 

R*4 

000010 

X 

R*4 e 

000000 


Subroutines# Functions# Statement and Processor-Defined Functions: 

Name Type Name Type Name Type Name Type Name Type 

SORT R*A 


The first part of the listing shows the main program unit and 
consists of the language statements up to, but not including, 
the function. This is followed by a diagnostics list, then by a 
storage map. Next the language statements composing the 
function program unit are listed, again followed by a diagnos¬ 
tics list and a storage map. 

Before considering the individual sections of the program list¬ 
ing, first examine the program logic to determine what this 
program should do. The first few lines of this program are user 
comment lines that briefly describe the program. Essentially, 
this program produces on the terminal a graph of a "three- 
dimensional” function, FUN(X, Y). The graph is plotted using 
45 lines down and 72 characters across the terminal page. The 
limits of the X and Y axes are -1-5 and -5. The third dimension, 
height, is a real number within the range 0 to 1 and is repre¬ 
sented in the listing as a number within a scale of 1 to 9. These 
dimensions are illustrated in Figure 9—3. 

The SCAL function determines the value of the next coordinate 
on the graph. The statements within the DO loops calculate the 
coordinates using the SCAL function and determine the height 
value. This is done for an entire line of coordinates across the 
terminal page. The entire line is then printed on the terminal, 
using the CALL PUTSTR statement; the number 7 in this 
statement is the FORTRAN IV method of naming the terminal 
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72 Characters 


-6 



Figure 9-3 Dimensions of FUN(X,Y) 

as the output device. This procedure is repeated until all 45 
lines of the graph have been printed. 

The function to be plotted is shown in the last few lines of the 
program. It is compiled as a separate program unit and you can 
edit these lines to plot any function of your choice (several al¬ 
ternate functions are suggested later in the chapter). 

This program as it stands contains errors. The compiler de¬ 
tected certain error conditions during processing that prevent 
the program from working properly. The compiler printed ap¬ 
propriate messages in the diagnostics sections of the program 
listing.* Look first at the messages following the main program 
unit. Errors were discovered in lines 3, 4, 8, 12, and 16. 

The messages for lines 3 and 4 indicate that the floating-point 
variables "XMIN” and "YMIN” are assigned integer values. 
The DATA statements must be changed. (The same error exists 
for "XMAX” and "YMAX”; the compiler, however, lists only the 
first error that it discovers in a line. Both "MAXX” and 
"MAXY” are integer variable names, so no error exists for 

them. ) You must correct the DATA statements (lines 3 and 4), 

then, as follows: 

DATA XMIN»XMAX>MAXX/-5.0»5.0»45/ 

DATA YMIN .YMAX»MAXY/-5.0*5.0(72/ 

The next two messages in the diagnostics section show that 
reference has been made from both lines 8 and 12 to an unde¬ 
fined label. (Line 12 is actually the second portion of line 11, 
the GO TO statement.) Statement label 20 is referenced in each 
case, but only labels 10 and 30 are shown in the program. This 
indicates either that a statement is missing or that a t3rping 


‘Refer to the RT—11 System Message Manual for greater detail about any 
system messages printed. 
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LINKING OBJECT 
MODULES TOGETHER 


error exists. Examination of the program logic shows a typing 
error in line 17. Label 30 should actually be 20. Correct line 17 
as follows: 

20 CALL PUTSTR(7>STRING»' ') 

The last message in this diagnostics section states that an in¬ 
correct number of subscripts was given for the array "STRING”. 
Again, examination of program logic shows that the error is 
actually in line 1. "STRING” is really a vector (a one-dimension 
array), not a matrix (a two-dimension array). Thus the comma 
is a typing error and line 2 should be changed as follows: 

LOGICAL*! STRING(133)»STAB(100) 

Skip next to the diagnostics section for the FUN program unit. 
The message printed there refers you to the source listing, to 
line 3. A letter "P” appears next to this line. The RT-11 System 
Message Manual describes a P error as an indication of unbal¬ 
anced parentheses. Notice that the parentheses are not prop¬ 
erly matched in this line. Thus, line 3 should be corrected as 
follows: 

FUN=(X*Y*R*EXP(-R ))**2 

This explains the errors flagged by the compiler in the diagnos¬ 
tics sections. Other sections of the program listing (storage 
map, for example) simply provide additional information that is 
helpful to programmers who wish to check the data t 5 T)es of 
various symbols and later make sure that object modules have 
been appropriately linked. 

Before you can continue the exercises in this chapter, you must 
edit, in the source program, those statements that contain er¬ 
rors. If necessary, review the editing commands in Chapter 5. 
Then use the RT-11 editor to edit the file GRAPH.FOR on your 
system volume so that the five lines are error-free. Do not re¬ 
name the file. When you are ready, recompile the program, 
using the FORTRAN command, and obtain a new object module 
and a new listing. This time the program should compile with¬ 
out error (that is, no diagnostics should list). The compiler will 
indicate two warnings, but you can ignore them. If diagnostics 
occur, you have not edited the program correctly. Compare list¬ 
ings and try to correct your errors, or go back to the beginning 
of this chapter and repeat the demonstration. 


The object module produced by the FORTRAN command is in 
itself incomplete. As mentioned earlier, it needs parts of the 
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system library, SYSLIB, and perhaps other object modules and 
libraries as well, to form a complete functioning program.* All 
required object modules must be joined, or linked together, be¬ 
fore the program can work. 

Even if your program does not require any other object mod¬ 
ules, you must still link it. In addition to joining object mo|dules 
together, the link operation adjusts the object code to account 
for many program units being placed one after the other. The 
result of the link operation is a memory image load module, 
which is actually a picture of what computer memory looks like 
just before program execution. Figure 9-4 is a diagram of the 
link operation. 



Figure 9-4 The Link Operation 


To link the object modules, use the monitor LINK command. 
The system prompts you to enter the names of the input mod¬ 
ules and any libraries other than the system library to be joined 
together. You can omit typing the .OBJ file types in the com¬ 
mand line, since the LINK command assumes this file type for 
input. The system automatically assigns the file name of the 
first input file and a file type of .SAV to the output file. The 
linker will scan the SYSLIB library if it is present on the sys¬ 
tem volume. 

Some RT-11 systems store the linker (LINK.SAV) and the de¬ 
fault system library (SYSLIB.OBJ) on a volume apart from the 


LINK 


*For more information on linking files and using library files, see Chapters 12 
and 13, respectively. 
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system volume or the FORTRAN/BASIC language volume/ 
You can quickly determine whether the system library is on 
your system volume by using the DIRECTORY command. 

, DIRECTORY SY : SYSLIB . OBJ®S) 

If SYSLIB.OBJ did not appear in the directory listing on your 
terminal, the required files are not part of your system volume. 
Before you can link GRAPH.OBJ, you must make a volume 
substitution. Read the section entitled Using the LINK Volume 
in Appendix B. 

If you have not included the FORTRAN IV library FOR- 
LIB.OBJ in SYSLIB, use the DIRECTORY command to see if 
the library is on your system volume. Type: 

, DIRECTORY SY : FORLIB . OB J® 

If FORLIB.OBJ did not appear in the directory, the required 
files are not part of your system volume. Before you can link 
GRAPH.OBJ, you must make a volume substitution. Read the 
section entitled Using the LINK Volume in Appendix B. 

Long Command Format 
FORLIB not included in SYSLIB: 

. LINK® 

Files? GRAPH .SYSLIB »FORLIB® 

FORLIB included in SYSLIB: 

, LINK® 

Files? GRAPH® 

Short Command Format 
FORLIB not included in SYSLIB: 

.LINK GRAPH .SYSLIB .FORLIB® 

FORLIB included in SYSLIB: 

. LINK GRAPH® 

Any messages printed on the terminal identify error conditions 
discovered by the system during the link operation (for exam- 


^This is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the files required for linking. The RXOl diskette is an 
example. 
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pie, you may not have specified all the object modules that are 
needed as input). However, assuming' that you edited your 
source program correctly and that it compiled without error, it 
should also now link without error. 

A load module is one that you can run on the system. Unless 
your program contains logic errors that prevent it from running 
properly (errors that the system cannot always detect), running 
the .SAV version of your file should produce the results you 
intended. However, if logic errors exist within your program, 
running the program will produce either erroneous results or 
none at all. If this is the case, you must study the source pro¬ 
gram, rework it, reedit it, and perform the compile and li nk 
operations again. 


If your FORTRAN IV program is error-free, running the .SAV 
version should produce the expected results. In this demonstra¬ 
tion, running the GRAPH.SAV file should produce a graph on 
the terminal printer or screen. 

Before you run GRAPH.SAV, you have the option of changing 
the output device from the terminal printer or screen to the line 
printer by using the monitor ASSIGN command to assign de¬ 
vice names (see Chapter 4, Assigning Logical Names to De¬ 
vices). If you prefer to print the graph on the line printer, sim¬ 
ply assign the logical device name 7 (which is the FORTRAN 
IV code for the terminal) to the line printer code (LP:). You 
have designated a new output device without altering the 
source program. To change the device assignment to the line 
printer, type: 

Long Command Format 

ASSIGN® 

Physical device name? LP:® 

Logical device name? 7® 

Short Command Format 

, ASSIGN LP: 7® 

This assignment remains in effect until you deassign the names 
or reboot the monitor. 

Now, to execute the FORTRAN IV demonstration program, use 
the monitor RUN command. You can omit typing the .SAV file 
type since it is assumed within the RUN command. 

Long and Short Command Format 

. RUN GRAPH® 


RUNNING THE 
FORTRAN IV 
PROGRAM 


RUN 
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After a brief pause, the graph begins to print on the terminal 
(or line printer) and should look like the graph shown in Figure 
9-5. 


♦♦*♦♦*♦♦♦♦♦*♦♦♦♦♦♦♦♦♦****♦♦♦**♦*♦**♦♦**♦*♦♦♦♦♦♦♦♦*♦***♦*♦*♦*♦♦♦♦♦*♦♦**♦* 
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Figure ft-5 The Result of GRAPH.SAV 


COMBINING To produce these results, you first compiled the FORTRAN IV 

OPERATIONS source program (GRAPH.FOR), then linked it with the default 

library (SYSLIB.OBJ), and finally ran the resulting .SAV file 
(GRAPH.SAV). You can combine these three operations using 
one monitor command, the EXECUTE command. 

NOTE 

The use of the EXECUTE command requires the follow¬ 
ing files on your system volume; 

FORTRA.SAV LINK.SAV GRAPH.FOR 

SYSLIB.OBJ FORLIB.OBJ (if not included in SYS- 

LIB) 

If you have substituted the special LINK volume for your 
system volume, you do not have the necessary files to 
use the EXECUTE command. Proceed to the next sec¬ 
tion, entitled Alternate Functions. 


EXECUTE 
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The EXECUTE command instructs the system to select the lan¬ 
guage processor, then process, link, and run the program. There 
are several ways to establish which language processor the EX¬ 
ECUTE command invokes. One way is to specify a language- 
name option, such as /MACRO, which invokes the MACRO as¬ 
sembler. Another way is to omit the language-name option and 
specify the file type for the source files. The EXECUTE com¬ 
mand then invokes the language processor that corresponds to 
that file type. Specifying the file GRAPH.FOR, for example, 
invokes the FORTRAN IV compiler. A third way to establish 
the language processor is to let the system choose a file type of 
.MAC, .DEL, or .FOR for the source file you name. If, for exam¬ 
ple, you specify the file GRAPH, the monitor searches device 
SY: (your system device) for the files GRAPH.MAC, 
GRAPH.DBL, and GRAPH.FOR, in that order. If the monitor 
finds neither GRAPH.MAC nor GRAPH.DBL, it invokes the 
FORTRAN IV language processor to compile GRAPH.FOR. For 
example, to combine the compile-link-run operations that you 
performed in this chapter, you would use the following com¬ 
mand (do not actually type this command until you have read 
the next section. Alternate Functions): 

Long and Short Command Format 

FORLIB not included in SYSLIB: 

• EXECUTE GRAPH/F 0 RTRAN/LIST/LINKLI 6 :SySLI 5 /LINKLI 6 !F 0 RLIB® 
FORLIB included in SYSLIB: 

• EXECUTE GRAPH/FORTRAN/LIST® 


The following are some alternate functions that you can substi¬ 
tute in your FORTRAN IV source program to produce different 
graphs. Simply reedit the program (GRAPH.FOR) so that lines 
1-5 in the function portion at the end contain one of the follow¬ 
ing alternate functions. Then compile, link, and run the pro¬ 
grams as described in the previous sections. If the necessary 
files are available on your system volume (see the previous sec¬ 
tion, Combining Operations), use the EXECUTE command to 
run the program. The source program compiles, links, and runs, 
and the new graph prints on the terminal (or line printer). 

Function 1 

FUNCTION FUN(X .Y) 

FUN = EXP(-S 0 RT(X»» 2 +Y** 2 ) ) 

RETURN 

END 

Function 2 

FUNCTION FUN(X.Y) 

R=S 0 RT(X** 2 +Y»» 2 ) 

FUN=X»Y»(R- 3 ,)/( 1 .+EXP( 3 .*(R- 3 . 5 ))) 

RETURN 

END 


ALTERNATE 

FUNCTIONS 
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Function 3 



FUNCTION FUN(X»Y) 

FUN=EXP(+S0RT(X**2+Y»*2))/1177.4 

RETURN 

END 

SUMMARY: 
COMMANDS TO 

RUN FORTRAN 
PROGRAMS 

EXECUTE 

Combine the compile-link-run operations into one command. 

EXECUTE file 

Combine the compile-link-run operations into one command. 
Specify the libraries to be used during linking. 

EXECUTE file/FORTRAN 

Combine the compile-link-run operations into one command, 
and specify the input file to be a FORTRAN file. 

EXECUTE/LIST 

Combine the compile-link-run operations into one command. 
Obtain a listing file of the source program and print on line 
printer. 

FORTRAN 

Compile the FORTRAN IV source program and produce an 
object module. 

FORTRAN/LIST 

Compile the FORTRAN IV source program and produce both 
an object module and a listing file. 

LINK 

Link individual object modules together to form a complete 
program and produce a load module. 

RUN 

Run the indicated load module. 

FILE MAINTENANCE 

Before continuing further you should perform the necessary file 
maintenance operations. 

NOTE 

If you used a special LINK volume to perform this dem¬ 
onstration, turn now to the section entitled FOR¬ 
TRAN/LINK File Maintenance in Appendix B. 

Obtain a directory of all files on your system volume that have 
the name GRAPH regardless of file type; these files were cre¬ 
ated as a result of the exercises in this chapter. 
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Long and Short Command Format 

• DIRECTORY GRAPH.*® 

08-Jan-83 

GRAPH .SAO 21 08-Jan-83 GRAPH ♦LST 8 08-Jan-83 

GRAPH .BAK 2 08-Jan-83 GRAPH ♦FOR 2 08-Jan-83 

GRAPH ♦OBJ 18 08-Jan-83 

5 Files t as BlocKs 
aai Free blocks 

The fact that you have corrected errors in the source file 
GRAPH.FOR makes the version of that file on your storage 
volume obsolete. Therefore, transfer the updated copy from 
your system volume to VOL:, replacing the copy of 
GRAPH.FOR on the storage volume with the new version. 


Long Command Format 

• COPY® 

From? GRAPH.FOR® 

To ? yOLsGRAPH.FOR® 

Short Command Format 

• COPY GRAPH.FOR OOL: GRAPH . FOR® 

Similarly, transfer GRAPH.LST, GRAPH.OBJ, and 
GRAPH.SAV to your storage volume. This allows you to exam¬ 
ine a listing or rerun the FORTRAN IV program without re¬ 
compiling and relinking the source. 


Long Command Format 

. COPY® 

From? graph.LST .GRAPH. OBJ .GRAPH . SAO® 
To ? OOLi® 

Files copied: 

DK:GRAPH^LST to : GRAPH ♦ LST 
DK:GRAPH^OBJ to VDL:GRAPH♦OBJ 
DK:GRAPH^SAV to VOL:GRAPH♦SAU 


Short Command Format 

‘COPY GRAPH.LST .GRAPH.OBJ .GRAPH.SAV VOL:® 
Files copied: 

DK:GRAPH.LST to VOL:GRAPH.LST 

DK:GRAPH.OBJ to VOL:GRAPH.OBJ 

DK:GRAPH.SAV to VOL : GRAPH.SAV 


Once you have transferred all files of value to your storage 
volume, delete the useless files — that is, all the GRAPH 
files — from the system volume. 
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REFERENCES 


Long Command Format 

. DELETE® 

Files? GRAPH.*® 

Files deleted: 
DK:GRAPH.5AK ? Y® 
DK:GRAPH.SAD ? Y® 
DK:GRAPH.FOR ? Y® 
DK:GRAPH.LST ? Y® 
DK:GRAPH.OBJ ? Y® 


Short Command Format 

. DELETE GRAPH.*® 

Files deleted; 

DK:GRAPH.BAK ? Y® 

DK :GRAPH. SAD ? Y® 

DK:GRAPH.FOR ? Y® 

OK:GRAPH.LST ? Y® 

DKrGRAPH.OBJ ? Y® 

Finally, obtain an up-to-date directory listing of your storage 
volume so that you can see its current status. 

Long and Short Command Format 

. DIRECTORY DOL:® 

08-Jan-83 

SUM .MAC 3 08-Jan-83 EXAMP .FOR 2 2G-AuS-82 

EXAMP .MAC 3 2G-Ausl-82 GRAPH .FOR 2 08-Jan-83 

GRAPH .LST 8 08-Jan-83 GRAPH .OBJ IS 08-Jan-83 

GRAPH .SAD 21 08-Jan-83 

7 Files. 55 blocks 
4707 Free blocks 

This completes the FORTRAN IV demonstration. Continue to 
Chapter 12 to read about the linking process. If you followed 
the special instructions in Appendix B to load the language 
volume, leave this volume in device unit 0 until you have fin¬ 
ished Chapter 12. 


McCracken, Daniel D., A Simplified Guide to FORTRAN Programming. New 
York: Wiley, 1974. 

An introduction to programming in the FORTRAN language. 

PDP-11 FORTRAN Language Reference Manual (AA-1855D-TC). Maynard, 
Mass.: Digital Equipment Corporation, 1980. 

A reference manual and guide to programming in the PDP-11 FOR¬ 
TRAN IV language. 

RT-11 FORTRAN IV Installation Guide (AA-5240E-TC). Maynard, Mass.: 
Digital Equipment Corporation, 1980. 

An RT-11-specific manual that contains instructions for installing the 
RT-11 FORTRAN IV language processor, and describes known prob¬ 
lems and differences between versions. 

RT-11 RSTS-E FORTRAN IV User’s Guide (AA-5749B-TC). Maynard, 
Mass.: Digital Equipment Corporation, 1980. 

An RT-11-specific manual that contains information necessary to com¬ 
pile, link, run, and debug a FORTRAN IV program. 
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CHAPTER 10 
RUNNING A BASIC-11 PROGRAM 


The BASI^ll program lan^age* is a machine-independent 
programming language that is one of the easiest languages for 
the beginning programmer to learn. It has both elementary lan¬ 
guage features that you use to write simple programs, and more 
advanced operations that allow you to produce complex and effi¬ 
cient programs. In addition, a special "immediate mode” lets 
you use BASIC—11 like a calculator to obtain instant answers 
to mathematical problems. 


BASIC (Beginner’s All-purpose Symbolic Instruction Code) -11 
is conversational in nature. It uses simple English keywords 
and common mathematical expressions to form easily under¬ 
stood language statements. 

You write a B ASIC—11 program as a series of one or more pro¬ 
gram lines. You begin each program line with a number that 
both identifies the line and indicates the order in which the line 
will be processed. Individual program lines contain one or more 
BASIC-11 language statements that define the operations to be 
performed. 

When you are satisfied with the logic of your BASIC-11 source 
program, you create it as a file. However, unlike your methods 
under other programming languages, you create the file under 
the control of the BASIC—11 language processor, which is part 
of the RT—11 operating system and is stored on your system 
volume or on a separate volume of its own. Thus, you use com¬ 
mands that are part of the BASIC—11 language processor to 
create and edit the program, list it, run it, and save it for later 
use. 


DEVELOPING 
A BASIC-11 
PROGRAM 


The BASIC—11 language processor is an interactive interpreter. 
It allows you to create and execute a program in its entirety or 
a few lines at a time. The interpreter examines each program 
language statement, interprets it, and executes it before going 
on to the next. If it discovers an error that prevents further 
processing, it prints on the terminal a message informing you of 
the error condition and stops. You correct the error so that exe¬ 
cution can continue past that point, and then rerun the pro¬ 
gram. 


'BASIC-11 is a superset of the standard BASIC language developed at Dart¬ 
mouth College. 


USING THE 
BASIC-11 
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BASIC 



_I 


Figure 10-1 Functions of the BASIC-11 
Language Processor 


USING THE 

BASIC-11 

INTERPRETER 


BASIC 


The functions of program creation, editing, processing, and exe¬ 
cution are all handled by the BASIC-11 language processor. 
Some RT-11 systems store the BASIC-11 interpreter (language 
processor) on a volume apart from the system volume.^ You can 
quickly determine whether the BASIC-11 interpreter is on 
your system volume by typing the monitor DIRECTORY com¬ 
mand and specifying the BASIC.SAV program. 

• DIRECTORY BASIC.SAO® 

In the directory listing that results, if the directory entry for 
BASIC.SAV is listed on your terminal, then the required 
BASIC-11 files are on your system volume and you are ready to 
use the interpreter. However, if BASIC.SAV did not appear in 
your listing, then the required files are not part of your system 
volume. Before you can use the interpreter, you must make a 
volume substitution. Read the section in Appendix B entitled 
Using the FORTRAN/BASIC Language Volume. 

Now use the monitor BASIC command to activate the 
BASIC-11 interpreter: 

Long and Short Command Format 

• BASIC® 

BASIC-ll/RT-11 02.1 

OPTIONAL FUNCTIONS (ALL. NONE. OR INDIOIOUAD? 

A prompting message is printed by BASIC—11. You must re¬ 
spond with an A, N, or I and a carriage return to indicate 
whether you want to preserve all, none, or some of the arithme¬ 
tic functions initially provided by BASIC-11. BASIC-11’s func¬ 
tions include operations that calculate random numbers, deter- 

^Thls is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the BASIC!-11 system files. RXOl diskette is an 
example. 
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mine absolute values, convert octal and binary numbers to deci¬ 
mal, and so on. You can conserve memory space by saving only 
those functions that your program needs. For now, however, 
instruct BASIC-11 to save all the functions. 

A® 

READY 


BASIC—11 prints the READY message to indicate that it is 
ready to accept a BASIC-11 command. Any text that you type 
that is not preceded by a BASIC-11 command is accepted as 
program (or immediate mode) input. If at any time you wish to 
return to the monitor command mode, simply type the BYE 
command following the READY message. READY appears 
after any BASIC—11 execution that is completed or interrupted 
by a double CTRL/C, or after any BASIC-11 wait condition that 
is terminated by a single CTRL/C. 

NOTE 

You do not need to understand the BASIC-11 language 
or the way the examples work to perform successfully 
the exercises in this chapter. 


Immediate mode allows you to use the BASIC-11 interpreter 
like a calculator to obtain immediate answers to arithmetic 
problems. You enter the appropriate BASIC-11 statement key¬ 
word and any necessary mathematical formula. When you 
press the carriage return key, BASIC-11 immediately calcu¬ 
lates and prints the results. (Use the terminal DELETE key 
and the CTRL/U command to correct any typing errors.) 

PRINT (128+75)*3® 

609 

BASIC—11 adds the two numbers in parentheses, multiplies 
them by 3, and prints the answer. The PRINT statement causes 
the answer to be printed on the terminal. The following com¬ 
mand provides another example: 

PRINT INT(3a.67)® 

34 

READY 

The greatest integer less than or equal to 34.67 is printed. 

You can combine several statements on a single line, or on 
several lines, including variable names, arithmetic equations, 
and data. Individual statements are separated from one an¬ 
other by a backslash (\) character. BASIC-11 considers all the 


BYE 


Immediate Mode 


PRINT 
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information, calculates the answer and prints it on the ter¬ 
minal, as illustrated in the following example: 

A = 5\B=14\C=.3729® 


Creating and Editing 
a BASiC-11 Program 


SUB 


READY 

PRINT "THE HEIGHT IS" 5 A*SIN ( C)+B i "METERS“® 

THE HEIGHT IS 15.B21G METERS 

READY 

The first statement equates variable names with values; the 
second statement introduces a formula for calculating a result 
and prints it. 

You can use immediate mode to solve fairly lengthy and com¬ 
plicated mathematical problems by combining statements and 
printing identifying messages. However, immediate mode infor¬ 
mation is temporary. You cannot save it, and you can change it 
only by retyping every statement line. If your needs are more 
complex, or if you want to save your statements, you should 
create a BASIC-11 program. 


To create a BASIC-11 program, assign line numbers to lan¬ 
guage statements and then type the numbered statements on 
the terminal keyboard. 

Now your program lines are saved in memory and you can 
transfer program control to specific lines within the program, 
repeat parts of the program any number of times, store the 
entire program for later use, and perform other similar opera¬ 
tions that are not possible in immediate mode. 

Onpe you have created the program, you use BASIC-11 editing 
commands to list lines, change lines, add and erase lines, and 
correct typing errors. In addition to the DELETE key and the 
CTRL/U command, BASIC-11 provides a SUB command (SUB¬ 
STITUTE) for correcting typing errors. This command allows 
you to substitute new characters for existing ones in a line. For 
example, type: 

10 PRINT "THIS IS A BADIC PROGRAM"® 

SUB 10 HBADiaBASe® 

10 PRINT "THIS IS A BASIC PROGRAM" 

READY 

The SUB command substitutes the letters BAS for BAD in line 
10. Use a delimiting character (shown here as @) to separate 
the old text from the new. The delimiter can be any character 
as long as it is unique in the line. The corrected line is automat¬ 
ically printed by BASIC-11 after you use the command. As 
another example, type: 
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15 B=10\C = 5® 

20 LET A-B+C\PRINT C® 

There are two typing errors in line 20; the - should be an = 
and the C at the end of the line should be A. These errors can be 
corrected with the SUB command, as follows: 


SUB 20 @-@ = @® 

20 LET A=B+C \ PRINT C 


READY 

SUB 20 @C§A@2i 
20 LET A = B + C \ 1 


RINT 


A 


READY 


The second SUB command changes the second occurrence (spec¬ 
ified by the 2 after the last @) of C to A. 

You can erase an entire line by typing the line number followed 
by a carriage return: 

10 ® 

You can also use BASIC-ll’s DEL command'. Use the DEL 
command (DELETE) to erase a single line or several: 

DEL 15-20® 

This erases all statements with line numbers between and in¬ 
cluding 15 and 20. 

To list lines of a program, BASIC-11 provides the LIST com¬ 
mand. First, create a few program lines: 

5 FOR 1 = 1 TO 10® 

20 INPUT J® 

25 LET T = T+J® 

50 NEXT I® 

55 PRINT "THE TOTAL IS";T® 

88 END® 

List individual lines by specifying the line number. For ex¬ 
ample, type: 

LIST 5® 

NONAME 08-JAN-83 00:18;A8 

5 FOR 1=1 TO 10 

READY 


DEL 


LIST 


'Do not confuse the BASIC-11 DEL command with the DELETE key on the 
terminal keyboard. 
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LISTNH 


SCR 


Notice that BASIC-11 prints a header line. Since you have not 
as yet assigned a name to your program, BASIC-11 assigns it 
the name NONAME and prints this name, along with the date 
(which is only correct if previously entered via the DATE mon¬ 
itor command) and the time when you use the LIST command. 
You can omit the header line by using the LISTNH command 
instead of the LIST command. 

LISTNH 50-88® 

50 NEXT I 

55 PRINT "THE TOTAL IS" iT 
88 END 

READY 

By typing the LIST or LISTNH commands without indicating 
any line numbers, you can print on the terminal a listing of 
your entire program. Terminate the command with a carriage 
return. 

LISTNH® 

5 FOR 1=1 TO 10 
20 INPUT J 
25 LET T=T+J 
50 NEXT I 

55 PRINT "THE TOTAL IS"iT 
88 END 

READY 

Finally, to erase the entire program, which you must do before 
typing a new program, use the SCR (SCRATCH) command. 

SCR® 

READY 

All program lines are erased from memory. 


SUMMARY: 
BASIC-11 EDITING 
COMMANDS 


line # 

Erase the indicated program lines. 

DEL line # 

Erase the indicated program lines. 

LIST 

List the entire program and print a header that includes the 
program name, date, and time. 

LIST line # 

List the indicated lines and print a header that includes the 
program name, date, and time. 
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LISTNH 

List the entire program but do not print a header. 

LISTNH line # 

List the indicated lines but do not print a header. 

SCR 

Erase all program lines from memory and change the name 
to NONAME. 

SUB line #@FIRST@SECOND@n 
Replace the nth occurrence of the FIRST character(s) with 
the SECOND character(s) in the indicated line (default is 
n=l). 

Create the following demonstration programS using the appro¬ 
priate BASIC-11 editing commands, exactly as it appears here. 
If you forget to insert a line, type it at the end or when you 
notice the omission; BASIC-11 sorts and arranges lines by 
number before execution, regardless of the order in which they 
are typed. When you have finished, list the entire program and 
make a final check for typing errors. 


100 
101 
110 
115 
120 
125 
130 
135 
1^0 
200 
201 
210 
215 
230 
2^0 
250 
2G0 
270 
280 
290 

300 

301 
305 
310 
320 
330 
350 
3G0 
370 
380 
390 

aoo 

^01 

410 

440 

500 

501 
510 
999 


REM THE PROGRAM 23 MATCHES 
REM 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 


•'WE BEGIN 
"MAY TAKE 
"FOLLOWED 
"PUTER 
"AGAIN 


WITH 
1 » 2 
BY A 
CHOOSES 
AND SO 


23 MATCHES. YOU MOUE FIRST. YOU" 
OR 3 MATCHES. TYPE YOUR CHOICE" 
CARRIAGE RETURN. THEN THE COM-" 

1♦ 2» OR 3 MATCHES. YOU CHOOSE" 
ON. WHOEVER MUST TAKE THE LAST" 


"MATCH» LOSES.' 
\ LET M=23 


"THERE ARE NOW";Mi"MATCHES." 
"HOW MANY DO YOU TAKE" ; 


510 


REM THE HUMAN MOVES 
REM 

PRINT \ PRINT 
PRINT \ PRINT 
INPUT H 

IF H>M THEN 510 
IF H<>INT(H THEN 
IF H<=0 THEN 510 
IF H>=4 THEN 510 
LET M=M-H 
IF M=0 THEN 410 
REM THE COMPUTER MOVES 
REM 

IF M=1 THEN 440 
LET R=M-4*INT(M/4) 

IF ROl THEN 350 
LET C=INT(3*RND)+1 \ GO TO 
LET C=(R+3)-4*INT((R+3)/4) 

LET M=M-C 
IF M=0 THEN 440 

PRINT \ PRINT "THE COMPUTER TOOK"?C i" . 

GO TO 310 

REM SOMEBODY WON 

REM 

PRINT \ PRINT "THE COMPUTER 
PRINT \ PRINT "YOU WON." \ 

REM BAD INPUT 
REM 

PRINT "ENTER ONLY 1» 2t OR 3. 

END 


3G0 


WON. ' 
GO TO 


\ GO 
999 


TO 999 


\ GO TO 215 


^23 Matches, 101 BASIC Computer Games, Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1975. 
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As you can see from the first few lines of the listing, this pro¬ 
gram is a mathematical game where you match your logic 
against the program logic. The PRINT statements in the pro¬ 
gram print messages, game instructions, results, and so forth, 
on the terminal. The REM statements identify comment 
lines — remarks that provide general information about the 
program, but that are ignored by BASIC-11 during processing. 
The INPUT statement in line 230 allows you to supply data 
from the terminal. Depending on the value you enter, program 
control transfers to various other parts of the program. For ex¬ 
ample, if you type an invalid value, program control skips 
ahead to a PRINT statement in line 510 informing you of your 
mistake and then returns to line 215 to ask for a value again. 
The mathematical algorithms of this program are in lines 310 
through 350, which determine the number of matches the com¬ 
puter will select based on your choice. 


RUNNING A 
BASIC-11 PROGRAM 


RUN 


Once you have typed the program and checked the listing to be 
sure that it corresponds to the example, you are ready to run it. 
The BASIC-11 RUN command initiates program execution. 
This command prints a header that includes the program name, 
date, and time. If you want to omit the header line, type the 
RUNNH command instead. 

RUNNH® 


If you typed the program correctly, you will see this text print 
on your terminal: 


WE BEGIN WITH 23 MATCHES. YOU MOVE FIRST. YOU 
MAY TAKE 1. 2. OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM¬ 
PUTER CHOOSES 1. 2. OR 3 MATCHES. YOU CHOOSE 
AGAIN. AND SO ON. WHOEVER MUST TAKE THE LAST 
MATCH. LOSES. 

THERE ARE NOW 23 MATCHES. 

HOW MANY DO YOU TAKE? 


NOTE 

If this response does not appear, you have not entered 
the program correctly. Compare your listing very care¬ 
fully against the one provided earlier. Spacing does not 
matter, but all other characters must match. To correct 
your errors type CTRL/C, which, under control of 
BASIC-11 only, returns you to BASIC-11 command 
mode, indicated by the READY message. Correct the 
program and then rerun it. 
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When the program pauses and asks you a question, you must 
supply data, in this case a 1, 2, or 3. Type your choice (repre¬ 
sented here by n), followed by a carriage return: 

n® 


7SYNTAX ERROR AT LINE 250 
READY 

BASIC-11 discovered an error‘ in line 250 that prevents fur¬ 
ther processing. Check line 250 in your listing or list it on the 
terminal: 

LISTNH 250® 

250 IF HOINKH THEN 510 
READY 

Note that a right parenthesis is missing after the second H in 
this line. Correct the line using the SUBSTITUTE command: 

SUB 250 @(H@(H)@® 

250 IF H<>INT(H) THEN 510 

READY 

You are ready to run the program again. 

RUNNH® 


BASIC-11 begins processing at the start of the program. 


WE BEGIN WITH 23 MATCHES. YOU MOVE FIRST. YOU 
MAY TAKE 1. 2. OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM¬ 
PUTER CHOOSES 1» 2 , OR 3 MATCHES. YOU CHOOSE 
AGAIN, AND SO ON. WHOEVER MUST TAKE THE LAST 
MATCH, LOSES. 

THERE ARE NOW 23 MATCHES. 

HOW MANY DO YOU TAKE? 


Type your choice again. But notice this time that a different 
kind of error is detected. The BASIC-11 interpreter has entered 
an infinite loop, a series of commands that it repeats endlessly. 
After several lines have printed, type a double CTRL/C; this 
interrupts execution and returns control to BASIC-11 com¬ 
mand mode. 


CTRL/C CTRL/C 


^Refer to the RT-11 System Message Manual for greater detail about any 
messages printed during normal system use. 
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nffil 

THE COMPUTER TOOK 1 
THE COMPUTER TOOK 1 
THE COMPUTER TOOK 3 
THE COMPUTER TOOK 2 
THE COMPUTER TOOK 2 
THE COMPUTER TOOK 3 
THE COMPUTER TOOK 1 
THE COMPUTER TOOK 1 
THE COMPUTER TOOK 3 
THE COMPUTER TOOK 1 
THE COMPUTER TOOK 3 

ICTRL/CIICm/C) 

STOP AT LINE 380 
READY 


An infinite loop is a programming logic error. However, since 
the error does not prevent processing, BASIC-11 does not print 
an error message. Instead BASIC-11 is caught in a loop of in¬ 
structions and executes them endlessly. This .particular loop is 
obvious because it prints a line of text; other kinds of loops may 
not be so evident. At this point you must examine the program 
logic to determine why these instructions are being repeated. 

Look at your listing of this program. The problem in this case is 
in line 390. This line instructs program control to return to line 
310; therefore lines 310 through 390 are repeated endlessly 
without ever obtaining your next value choice. Program control 
should really return to line 210. Correct line 390 as follows: 

SUB 390 @31002100® 

390 GO TO 210 

READY 


Now you are ready to run the program again. This time the 
entire program should execute without error. Enter your value 
choices when requested. (A hint to playing the game: your first 
value choice determines whether you can win; if your first 
choice is wrong, the program has the advantage throughout.) A 
sample run follows. 

RUNNH® 

WE BEGIN WITH 23 MATCHES. YOU MOVE FIRST. YOU 
MAY TAKE li 2 , OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM¬ 
PUTER CHOOSES 1. 2. OR 3 MATCHES. YOU CHOOSE 
AGAIN. AND SO ON. WHOEVER MUST TAKE THE LAST 
MATCH. LOSES. 

THERE ARE NOW 23 MATCHES. 
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HOW MANY DO YOU TAKE? 

THE COMPUTER TOOK 1 .... 
THERE ARE NOW 21 MATCHES. 

HOW MANY DO YOU TAKE? 

THE COMPUTER TOOK 3 .... 
THERE ARE NOW 17 MATCHES. 

HOW MANY DO YOU TAKE? ^® 

THE COMPUTER TOOK 2 .... 
THERE ARE NOW 13 MATCHES. 

HOW MANY DO YOU TAKE? ^® 

THE COMPUTER TOOK 3 .... 
THERE ARE NOW S MATCHES. 

HOW MANY DO YOU TAKE? ^® 

THE COMPUTER TOOK 3 .... 
THERE ARE NOW 5 MATCHES. 

HOW MANY DO YOU TAKE? ^® 

THE COMPUTER TOOK 1 .... 
THERE ARE NOW 1 MATCHES. 

HOW MANY DO YOU TAKE? ®® 
ENTER ONLY It 2 t OR 3. 

HOW MANY DO YOU TAKE? ^® 

THE COMPUTER WON. 

READY 




RUN 

Execute the BASIC-11 program currently in memory; print a 
header line including the program name, date, and version 
number. 

RUNNH 

Execute the BASIC-11 program currently in memory; omit 
the header line. 

CTRL/C 

Under control of BASIC—11 only, interrupt execution of the 
BASIC-11 program and return control to BASIC-11 com¬ 
mand mode. 

BYE 

Return control to monitor command mode (only when using 
BASIC-11). 


SUMMARY: 

BASIC-11 

EXECUTION 

COMMANDS 
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FILE MAINTENANCE 


SAVE 


NEW 


OLD 


You can transfer the BASIC-11 program currently in memory 
to a storage volume by using the SAVE command of BASIC. 
The SAVE command copies the program to the storage volume 
and gives the program the file name and file type that you 
indicate in the command line. A file type of .BAS is assigned 
automatically unless you indicate otherwise. 

Use the SAVE command to store this BASIC-11 program as 
MATCH.BAS on the storage volume (VOL:) as follows: 

SAVE OOLsMATCH® 

READY 

After you save a BASIC-11 program on a storage volume, you 
can create a new program in memory by typing the BASIC-11 
NEW command. This command erases the current memory con¬ 
tents and asks you for a new program name: 

NEW® 

NEW FILE NAME-- 

You can type any file name you wish and BASIC-11 assigns it 
to the file you create. Or you can respond by typing only a 
carriage return; BASIC-11 then assigns the file name NO¬ 
NAME. 

Another way to create a new program in memory is to type the 
BASIC-11 SCR command. This command simply erases the 
current memory contents. It assigns the name NONAME: 

SCR® 

READY 

To use an existing BASIC-11 program, one that you have pre¬ 
viously stored on a storage volume, type the BASIC-11 OLD 
command: 

OLD® 

OLD FILE NAME-- 

Reply by typing the device name, file niime, and file type of the 
file that you want to use. If you omit ijn explicit device name, 
BASIC-11 assumes DK: (the default V olume); if you omit an 
explicit file type, BASIC-11 assumes iBAS. BASIC-11 erases 
memory and then copies the prograni from the volume into 
memory. For example, type: 

OOLrMATCH® 

READY 

This copies VOL:MATCH.BAS back into memory. 

Assume that you have edited or changed the MATCH.BAS file 
and now want to transfer it back to VOL:. Since the file already 
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exists as MATCH.BAS on that volume, you must use the 
BASIC-11 REPLACE command: 

REPLACE OOLrMATCH® 

READY 

The REPLACE command replaces an existing file with a new 
version. 

The SAVE and REPLACE commands copy a BASIC-11 pro¬ 
gram from computer memory to a storage volume. As these 
commands copy the program, they convert it from the internal 
format used by BASIC-11 to ASCII format. Thus, you can, if 
you prefer, use the RT-11 editor to create and edit BASIC-11 
programs, since the editor also uses ASCII format. However, 
many users would rather use BASIC-11 to create and edit a 
BASIC-11 program, since they can then run the program, 
reedit it, rerun it, and save the new version — all in BA¬ 
SIC-11 command mode — rather than perform the several cor¬ 
responding monitor commands. 

The last file maintenance operation that you should perform is 
to obtain an up-to-date directory of your storage volume so that 
you can see its current status; however, you must return to 
monitor command mode to do this. Type the BYE command; 
this BASIC-11 command (rather than CTRL/C) returns control 
to monitor command mode. Next use the DIRECTORY monitor 
command to check the status of your storage volume. 

6YE® 

. DIRECTORY/BRIEF yOL: 

08-Jan-83 

SUM tMAC EXAMP .FOR EXAMP .MAC GRAPH .FOR GRAPH .LST 

GRAPH .OBJ GRAPH .SAU MATCH .BAS 

8 Files# 58 Blocks 
4704 Free blocks 


REPLACE 


NEW 

Create a new BASIC-11 program, assigning the file name 
indicated. 

OLD 

Copy into memory an existing BASIC-11 program (for use 
under BASIC-11). 

REPLACE 

Copy the BASIC-11 program currently in memory to the in¬ 
dicated storage volume, replacing the version that already 
exists on that volume. 

SAVE 

Copy the BASIC-11 program currently in memory to the in¬ 
dicated storage volume. 


SUMMARY: 
BASIC-11 FILE 
MAINTENANCE 
COMMANDS 
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This completes the BASIC-11 demonstration. Before you con¬ 
tinue to Chapter 14 to learn about program debugging, make 
sure that the main system volume is loaded in device unit 0. If 
you followed the special instructions in Appendix B to load the 
language volume, you should now stop the system, unload that 
volume, load the main system volume, and rebootstrap the 
system. 
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An RT-11-specific manual that contains information necessary to 
create, edit, run, and debug a BASIC-11 program. 
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CHAPTER 11 

RUNNING A MACRO-11 ASSEMBLY LANGUAGE PROGRAM 


The MACRO-11 programming language is a machine-depend¬ 
ent programming language developed for the PDP-11 program¬ 
mer, or for the FORTRAN IV programmer who intends to com¬ 
bine assembly language routines and FORTRAN IV routines. 
The MACRO-11 language enables the knowledgeable program¬ 
mer to access all the features of the RT-11 computer system 
using a precise and efficient programming code. 


The MACRO-11 assembly language uses the PDP-11 instruc¬ 
tion set, a list of mnemonic instructions that correspond to vari¬ 
ous PDP-11 computer operations. These instructions allow you 
to add, compare, increment, complement, and perform many 
other manipulations on numerical data. The instructions are 
summarized in a pocket-sized folding card, called the PDP—11 
Programming Card (Figure 11—1), and are described in detail 
in the PDP-11 Processor Handbook. By choosing the appropri¬ 
ate instructions and by providing any additional data needed, 
you can create a complete program. 


B 1*^11 
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Figure 11-1 PDP-11 Programming Card 

You write the MACRQ-11 program as a sequence of lines, each 
a single assembly language statement in the following format: 

LABEL: OPERATOR OPERAND(S) COMMENTS 

The operator and/or operand are instructions selected from the 
PDP-11 instruction set, data needed by the instructions, or as¬ 
sembler directives (instructions to the assembler to guide the 
assembly process). The optional statement label identifies the 
statement line so that you can refer to the instructions or data 
on that line from other parts of the program. Optional com¬ 
ments describe generally what operations are being done. 
Sequences of language statements constitute a routine (to per¬ 
form a specific function); groups of routines and data compose 
the entire executable program. 
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USING THE 
MACRO-11 
LANGUAGE 
PROCESSOR 


When you are satisfied with the logic of your MACRO-11 
source program, you use the RT-11 editor to create it as a file 
(see Chapter 5). You use tabs and spaces to make the program 
more readable. When you have finished creating the program 
as a complete, edited file, you next enter it as input to the 
MACRO-11 language processor, which is part of the RT-11 
operating system and is stored on your system volume. The 
MACRO-11 language processor processes (assembles) the lan¬ 
guage statements, converting them into an internal machine 
language code called object code. This code is next processed by 
the system linker, which combines your program units and 
makes the program suitable for execution. Figure 11-2 repre¬ 
sents the development of an executable MACRO-11 program. 



Figure 11-2 Evolution of a MACRO-11 Program 


The MACRO-11 language processor is an assembler that ac¬ 
cepts information in one format (that is, your source program) 
and translates it into another format (that is, a machine lan¬ 
guage program). The assembler interprets and processes the 
assembly language statements, one at a time, and generates 
one or more computer instructions or data items. Since you 
originally use the editor to create a MACRO-11 program in 
ASCII format, you must next translate it into a machine format 
that the computer can use. The MACRO-11 assembler per¬ 
forms this conversion, producing as output a new version of the 
program, in object format, called an object module. You may 
request the MACRO assembler to produce a listing of the 
source program at the same time. The role of the assembler is 
represented below in Figure 11-3. 



Figure 11-3 Function of a MACRO-11 Assembler 
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Ehiring assembly processing, the MACRO-11 assembler: 

• Accounts for all instructions used within the source program 
and determines their relative positions in computer memory; 
it does this by means of a storage location (program) counter. 

• Keeps track of all user-defined symbols and their respective 
values in a symbol table. 

• Converts assembly language mnemonics, user-defined sym¬ 
bols, and data values into their respective machine language 
(object code) equivalents. 


The program counter keeps track of addresses in computer 
memory where instructions and data will be stored. 

PDP-11 computer memories are composed of physical storage 
locations that can hold numerical data. These locations are 
numbered consecutively from 0 up to the highest memory loca¬ 
tion, which varies according to the amount of memory acquired 
with the computer system (Figure 11—4). PDP-11 computers 
used in an RT-11 system have at least 32,768 bytes (16,384 
words). 



Figure 11—4 PDP-11 Computer Memory 


The Program 
Counter 
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The Symbol Table 


Machine Language 
Code 


During processing, the assembler converts each program lan¬ 
guage statement into numerical data (the object code) and as¬ 
signs the data a relative storage location. The system linker 
will convert the relative storage locations assigned by the as¬ 
sembler to absolute storage locations in the computer memory.^ 
The location’s associated number is called its address. As the 
assembler translates and assigns each statement, it updates the 
value of the program counter accordingly. 


Since you may not know which locations, or how many loca¬ 
tions, the program needs, you use symbolic names (variables, 
constants, and labels) to represent individual locations and 
their contents. As the assembler processes the source program, 
it constructs a symbol table, which is a compiled list of all the 
symbolic names and labels that you have used within the pro¬ 
gram. The MACRO-11 assembler defines each symbolic name 
by assigning an address or data value, as appropriate, and adds 
the symbol definition to the symbol table. After assembly, you 
can refer to the symbol table, which is printed at the end of the 
assembly listing, to find all symbol definitions. 


The third function of the assembler is to convert your 
MACRO-11 source language statements into machine lan¬ 
guage code (the object module). 


NOTE 

The following information will help you understand the 
assembly listing used later in this chapter. 

Machine language code is numerical data in the form of binary 
numbers (numbers composed of only the digits 0 and 1). Binary 
numbers are appropriate because the digits 0 and 1 can be eas¬ 
ily manipulated by the two-state electronic logic of the com¬ 
puter. 

For example, a typical assembled instruction in PDP-11 com¬ 
puter memory looks like this; 


location 

location 

address 

contents 


01000 

11000000 

01001 

11100101 


^The system linker is discussed in Chapter 12. 
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Since a single instruction requires two (or more) consecutive 
memory locations, the instruction is actually put together in 
memory in the following manner: 

high-order byte low-order byte 

01001 11100101 11000000 01000 

Each individual digit of the instruction is called a bit (binary 
digit). A single memory location, called a byte, contains 8 bits; 
two memory locations, called a PDP-11 word, contain 16 bits. 

The byte in the even-numbered memory address is called the 
low-order byte and is stored first; the byte in the odd-numbered 
memory address is called the high-order byte and is stored next. 
Both bytes together form one PDP-11 16-bit word (Figure 
11-5). 



Figure 11-5 PDP-11 Word 

The computer works in terms of 8-bit bytes and 16-bit words of 
binary data. However, binary numbers are generally too long 
and cumbersome to be used effectively by a programmer. But 
binary numbers can be easily represented as octal numbers 
(numbers composed of digits within the range 0 to 7). Since 
octal numbers are closer to the familiar decimal number system 
and are much more readable than binary numbers, the pro¬ 
grammer more often uses octal numbers than binary numbers. 

Table 11-1 shows the decimal numbers 0 through 10 and their 
respective octal and binary equivalents. Tables and formulas 
are available to calculate higher conversions. 

Thus, you can think of the binary instruction shown earlier in 
terms of its octal equivalent as follows (conversion is done from 
low-order to high-order byte in groups of three bits): 

high-order byte low-order byte 

01001 11100101 11000000 01000 

1 6 2 7 0 0 = 162700(8) 
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ASSEMBLING 
THE MACRO-11 
PROGRAM 


A MACRO-11 assembly listing shows the addresses of memory 
locations and their contents as octal numbers. The octal num¬ 
bers represent the respective binary machine language code 
that makes up the object module. 


Table 11-1 Decimal/Octal/Binary Conversion 


Decimal 

Octal 

Binary 

0 

0 

000 

1 

1 

001 

2 

2 

010 

3 

3 

oil 

4 

4 

100 

5 

5 

101 

6 

6 

110 

7 

7 

111 

8 

10 

1 000 

9 

11 

1 001 

10 

12 

1 010 


In Chapter 5 you used the RT-11 editor to create a MACRO-11 
source program; you then stored it on your storage volume. 
Since a source program is in ASCII format, the next step is to 
use the MACRO-11 assembler to convert the source program to 
object code. 

Copy the MACRO-11 source program from the storage volume 
back to the system volume (which is the default volume for 
input/output operations). 

On your storage volume are two MACRO-11 source programs, 
the one you created, SUM.MAC, and the one provided for you, 
DEMOXl.MAC, which was renamed to EXAMP.MAC in Chap¬ 
ter 7. Which of these you should copy depends on the results of 
the source comparison you performed in Chapter 6. If the com¬ 
parison resulted in no differences except for the title lines, copy 
your own program (SUM.MAC) as follows: 

Long Command Format 

* CQBjY® 

i-rom^ VOL: SUM. MAC® 

SUM.MAC® 

Short Command Format 

'COPY VOL: SUM. MAC SUM.MAC® 

However, if differences were listed in addition to the title lines, 
substitute the program EXAMP.MAC: 
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Long Command Format 

• COPY® 

From? gOL:EXAMP.MAC® 

To ? SUM.MAC® 

Short Command Format 

• COPY UOL;EXAMP.MAC SUM.MAC® 

Whichever source file you copied now resides on your system 
volume under the name SUM.MAC and is the file that you will 
process with the MACRO-11 assembler. The command used to 
assemble a MACRO-11 source program is the monitor MACRO 
command. 

Use the MACRO command with its /LIST and /CROSSREFER¬ 
ENCE options to assemble your source program and produce a 
cross-referenced assembly listing. The system prompt asks you 
to supply the input file name. You can omit typing the .MAC 
file type, since the MACRO command assumes this file type 
unless you indicate otherwise. The system will automatically 
assign the name SUM.OBJ to the object module and SUM.LST 
to the listing file, and store both newly created files on the 
system volume. (The system volume is the default storage vol¬ 
ume for input/output operations.) 

Long Command Format 

• MACRO® 

Files? SUM/LIST/CROSSREFERENCE® 

Short Command Format 

• MACRO SUM/LIST/CROSSREFERENCE® 

Assembly begins. When it is finished, a message similar to the 
following prints on the terminal printer or screen: 

7MACR0-W-Errors detected: G 
OK: SUM .DK:SUM/C = DK:SUM 

This message indicates that the assembler detected errors in six 
lines of the source program during processing. It helps at this 
point to look at the listing produced by the assembler for infor¬ 
mation. 

Long Command Format 

(Line Printer) (Terminal) 

. PR I NT® . type® 

Files? SUM.LST® Files? SUM.LST® 


MACRO 
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Short Command Format 
(Line Printer) 


(Terminal) 


• PRINT SUM.LSTEBI 


TYPE SUM.LST® 


Your listing should look like the following example. An expla¬ 
nation of this listing follows. You should refer to the listing as 
you read the accompanying explanation. 

NOTE 

You do not need to understand the MACRO-11 lan¬ 
guage or the way this program works to successfully 
complete the exercises in this chapter. 


SUM.MAC VERSION 1 


MACRO VOS.00 Saturday 08-Jari-83 09:21 Paae 1 


.TITLE SUM.MAC VERSION 1 


i 


.MCALL .TTYOUT. .EXIT, .PRINT 


N a 70. »N0. OF DIOITS OF 'E' TO CALCULATE 
'E' » THE SUN OF THE RECIPROCALS OF THE FACTORIALS 
1/0! + 1/1! + 1/2! + 1/3! + 1/4' T 1/S! + ... 


10 

11 000000 
12 000006 

13 000012 

14 000016 

15 000022 

16 000024 

17 000026 

18 000030 

19 000032 

20 000034 

21 000036 

22 000040 

23 000044 

24 000046 

25 000052 

26 

27 000054 

28 000056 

29 000060 

30 000062 

31 


012705 000106 

012700 000107 

012701 000000 

006311 

011146 

006311 

006311 

062621 

005300 

001371 

012700 000106 

014103 
012702 
005202 

160003 
103375 
060003 
010311 


exp: 


177777 


AR 32 000064 066167 000000 000000 


33 

34 000072 

35 000074 

36 000076 

37 000100 

38 

39 000104 

40 000106 

41 000112 

42 000114 

43 000116 

44 000120 

45 000122 

46 

47 000124 000107 


005300 

001363 

014100 

162700 000012 

103375 

062700 000072 

000000 

005011 

005305 

001334 


.PRINT 
MOV 
first: MOV 

MOV 

second: asl 

MOV 

ASL 

ASL 

ADD 

DEC 

DNE 

MOV 

third: MOV 

MOV 

fourth: INC 

SUB 

BCC 

ADD 

MOV 

ADD 

DEC 

BNE 

MOV 

fifth: sub 


tMESSAG 
*N,RS 
♦Ntl,R0 
«A,R1 
8R1 

9R1,-<SP> 

9R1 

9R1 

<SP)+,(R1)+ 
RO 

SECOND 
*N,RO 
-<R1),R3 
♦-1,R2 
R2 

R0,R3 

fourth 

R0.R3 

RJfBRl 


THIRD 
-<R1> »R0 
«10.,R0 


49 

50 

51 000342 
000345 
000350 
000353 
000356 
000361 
000364 


BCC 

ADD 

.TTYON 

CLR 

DEC 

BNE 

.EXIT 


.ENDR 


JPRINT INTRODUCTORY TEXT 
TNO. OF CHARS OF 'E' TO PRINT 
»N0. OF DIGITS OF ACCURACY 
JADDRESS OF DIGIT VECTOR 
JDO MULTIPLY BY 10 (DECIMAL) 
ISAVE *2 
;«4 
;«8 

;N0U *10, POINT TO NEXT DIGIT 
SAT END OF DIGITS? 

{BRANCH IF NOT 

{GO THRU ALL PLACES, DIVIDING 
{BY THE PLACES INDEX 
{INIT QUOTIENT REGISTER 
{BUMP QUOTIENT 

{SUBTRACT LOOP ISN'T BAD 

{NUMERATOR IS ALWAYS . 10*N 

{FIX REMAINDER 

{SAVE REMAINDER AS BASIS 

{FOR NEXT DIGIT 

{GREATEST INTEGER CARRIES 

{TO GIVE DIGIT 

{AT END OF DIGIT VECTOR? 

{BRANCH IF NOT 

{GET DIGIT TO OUTPUT 

{FIX THE 2.7 TO .7 SO 

{THAT IT IS ONLY 1 DIGIT 

{(REALLY DIVIDE BY 10) 

{MAKE DIGIT ASCII 
{OUTPUT THE DIGIT 
{CLEAR NEXT DIGIT LOCATION 
{MORE DIGITS TO PRINT"? 
{BRANCH IF YES 
{WE ARE DONE 


ilNIT VECTOR TO ALL ONES 


124 

040 

114 

040 

040 

111 

015 


no 

126 

125 

117 

105 

123 

012 


105 messag: .ascii /the value of e is:/ < 15-12 /2./ :2oo> 
101 

105 

106 
040 
072 
062 


000367 056 200 

52 

53 

D 54 000000' 


.EVEN 

.END EXP 


MACRO V05.00 Saturday 08-Jan-83 09:21 Paae 


SUM.MAC VERSION 1 
Symbol iabl* 

A - **»««« 

EXP OOOOOOR 


FIFTH OOOIOOR 
FIRST 000012R 


FOURTH 000052R 
MESSAG 000342R 


N = 000106 

SECOND 000022R 


THIRD 000044R 
.TTYON- »«**«« 


. ABS. 
Errors 


000000 

000372 

datactadt 


(RU,I,GBL,ABSfOVR) 

<RU,I,LCL,REL,CON) 


»«» Assanblar statistics 


Work file reads: 
Work file urites: 
Size of work file: 
Size of core eooi: 
Oearatina systaa: 


0 

O 

8222 Words 
15872 Words 
RT-11 


( 33 Pases) 

( 62 Paaes) 
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Ela^Md tia«: 00:00:04.34 
DK :8UH»OK:8im/C-0K:SUM 

SUH.MAC VERSION 1 MACRO VOS.00 Saturday 08-Jan-83 09:21 Ra«« 8-1 

Crosa rafaranca tabla (CREF VOS.00) 

.TTYON 1-41 

A 1-14 

EXP 1-11# 1-47# 1-S4 

FIFTH 1-37# 1-39 

FIRST 1-13# 1-44 

FOURTH 1-2S# 1-28 

MESSAG 1-11 1-Sl# 

N 1-7# 1-12 1-13 1-22 1-47 

SECOND Iris# 1-21 

THIRD 1-23# 1-3S 

SUH.MAC VERSION 1 MACRO VOS.00 Saturday 08-Jan-83 09121 Paaa H-1 

Crofts rafaranca tabla (CREF VOS.00) 

.EXIT 1-3# 1-4S 

.PRINT 1-3# 1-11 

.TTYOU 1-3# 

SUH.MAC VERSION 1 MACRO VOS.00 Saturday 08-Jan-83 09:21 Pada E-1 

Cross rafaranca tabla (CREF VOS.00) 

A 1-32 

D 1-S4 

M 1-11 1-47 

R 1-32 

U 1-14 1-41 


The first part of the listing has four logical sections, as follows: 

line octal octal statement line 

number memory instruction 

address value(s) 

The assembler assigns consecutive decimal line numbers to 
each line of the source program, including blank lines and com¬ 
ment lines. These numbers are used for reference purposes. The 
next column to the right shows the relative^ even-numbered 
octal memory (byte) addresses of storage locations assigned by 
the program counter to each instruction in the program. This 
program has been assigned relative memory addresses 0 
through 370. The third column (and possibly fourth and fifth) 
shows the octal equivalent of the assembled instruction or data 
value. An apostrophe following an octal value indicates a rela¬ 
tive value that must be modified before it can be used (the 
actual value is determined during linking). Finally, the source 
program as you created it appears in the right-hand portion of 
the listing. 

For example, look at line 18 of the listing: 


18 000030 00G311 ASL @R1 >*8 


The instruction ASL @R1 is stored in relative memory loca^ 
tions 30 and 31 as binary data (the comment, ;*8, is ignored): 

31 00001100 11001001 30 


0 0 6 3 1 1 


^The assembler assigns relative memory addresses to instructions. Actual 
addresses are not determined until the link operation is performed. Linking 
and address relocation are discussed in Chapter 12. 
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Some instructions require more than two memory locations; for 
example, those at lines 13 and 14. The number of memory loca¬ 
tions required depends upon the operation. 

Following the assembled code in the listing is the symbol table, 
an alphabetical listing of user-defined symbols and labels in the 
program and their respective definitions. Symbols are defined 
as values. For example, the symbolic variable name N is de¬ 
fined (in line 7) as 000106(octal) or 70(decimal), an absolute 
value. Labels are defined as addresses. The symbolic label 
FIRST is defined (in line 14) as 000012, a relocatable address 
(the R following 000012 in the symbol table indicates that the 
address will be relocated or modified during linking). A row of 
asterisks next to any symbolic name in the table indicates that 
for some reason — possibly a programming error — the as¬ 
sembler could not define the symbol. 

At the very end of the symbol table (where the . ABS. occurs) is 
the program’s size information (or synopsis) in terms of the to¬ 
tal number of octal storage locations it requires (in this case, 
372). Following is the number of errors detected, and the 
amount of free and used memory pages (statistics provided by 
the assembler). 

Following the symbol table is the cross reference (CREF) list¬ 
ing. The CREF listing is optional — as is the assembly 
listing — but provides you with useful reference and debug¬ 
ging information, especially if the program is large. The CREF 
listing can contain several kinds of tables of reference informa¬ 
tion, each beginning on a new page. The default tables are the 
three shown here. 

Every reference in a CREF table shows the page number of the 
listing (in the preceding example, all references are on page 1), 
followed by the appropriate line number. A number sign follow¬ 
ing a line number indicates that this line is where a label or 
symbol definition occurs. 

The first CREF table shown here lists alphabetically all user- 
defined symbol and label references. 

The second CREF table lists alphabetically all macro symbol 
references. (Macro symbols are a special feature of the 
MACRO-11 assembly language; they are described shortly.) 

The third CREF table lists alphabetically the codes of the er¬ 
rors detected during assembly. These errors must be corrected 
before you can run the program. 

Now that you are familiar with the format of an assembly list¬ 
ing, go back to the beginning of the example listing to deter¬ 
mine what this program should do. 
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The first two comment lines (preceded by semicolons) indicate 
that the program calculates the value of'E’, which is the sum of 
the inverse of the factorials between 1 and infinity. The algo¬ 
rithm used in this program is somewhat complicated (this was 
necessary to keep the program reasonably short). 'E’ is calcu¬ 
lated one digit at a time by using a difference function between 
its actual value and the current approximation for each new 
digit. The program forms: 

1 -f- (1 -Kl -H... -Hd + ((1 -Kl/N))/(N-l))/(N-2))/.../2)/l) 

and is 2.11111... in the inverse factorial base system, which is 
the first sum shown in the program listing. 

The statements between lines 1 through 7 define initial states 
to the assemblers, such as the value of N, and designate the 
macros that will be used throughout the program. 

Macros, from which the MACRO-11 language processor derives 
its name, are a useful feature of the MACRO-11 assembly lan¬ 
guage. You can define as a macro any recurring sequence of 
coding instructions. By giving the macro a name, you can there¬ 
after call it from any other part of the program by using a 
single language statement. 

In addition to the macros you define yourself, the RT-11 system 
provides system macros that your programs can access. System 
macros are defined in a special system library file called SYS- 
MAC.SML (SML stands for System Macro Library). SYS- 
MAC.SML is part of the RT—11 operating system and is stored 
on the system volume. If you request a system macro from your 
source program, the MACRO-11 assembler automatically 
searches SYSMAC.SML for the required information. 

The system macros defined in SYSMAC.SML are calls to cer¬ 
tain services performed by the RT-11 monitor, such as terminal 
handling, input and output operations, program termination, 
file capabilities, and so on. The portion of the monitor that per¬ 
forms these services, or that is capable of getting the necessary 
program code to perform these services, is always in memory 
and is therefore called the resident monitor. Thus, whenever 
your source program is in memory and is to be executed, the 
resident monitor is also there with its services. 

You communicate the need for a monitor service by issuing a 
programmed request in your source program. A programmed 
request consists simply of a macro call to a specific macro de¬ 
fined in SYSMAC.SML. The macro expands into the appropri¬ 
ate machine language code, which, during program execution, 
makes a request to the resident monitor to supply the desired 
service. 
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You specify all programmed requests that you intend to use in 
your source program in an .MCALL statement, like the one 
shown at line 3 in the listing. For example, the programmed 
request .TTYOUT requests the monitor to print an ASCII char¬ 
acter on the console terminal. During assembly, the .TTYOUT 
macro in SYSMAC.SML is expanded into machine language 
code. During program execution this code requests the resident 
monitor to take the indicated ASCII character and send it to 
the console terminal. 

Line 12 in the program uses another programmed request, 
.PRINT, to print a message on the terminal. 

Lines 13 through 15 are initialization instructions: they set ini¬ 
tial values in three of the special registers. Lines 16 through 22 
represent a routine that does a multiplication by 10. Lines 23 
and 24 are setup instructions for the division routine of lines 25 
through 28. Lines 29 through 35 save the quotient and remain¬ 
der. Lines 36 through 40 print the digits of E. Lines 43 and 44 
count the number of digits. 

The statements at lines 47 through 49 reserve a buffer area (a 
series of locations in memory) to be used by the program and 
therefore not to be assigned to other instructions. The state¬ 
ment at line 51 provides the data for printing the ASCII text 
message THE VALUE OF E IS: 2. 

This program, however, contains errors. The assembler discov¬ 
ered six lines with errors that prevent the program from assem¬ 
bling properly. The assembler flags (points out) errors by print¬ 
ing a code letter in the assembly listing or on the terminal if no 
listing is requested. ‘ 

The first error occurs at line 12 and is an M error. This means a 
label was defined more than once. You can refer to a label any 
number of times, but you may define it only once. By looking at 
the CREF user symbol table, you can see that the label is de¬ 
fined at line 12 and again at line 47; one of these definitions is 
wrong. Examination of the program logic reveals that the defi¬ 
nition at line 12 is correct. Before deciding how to change line 
47, though, check the other errors to see if one of them indicates 
what should be done. In fact, the next error encountered (line 
15) shows what is wrong. A U error identifies an undefined 
S5anbol. The label A is referenced in line 15, but is never de¬ 
fined within the program. It should be defined logically at line 
47. Therefore, line 47 should be changed to read: 

A: .KEPT N+1 


^Refer to the RT-11 System Message Manual for greater detail about any 
system messages printed during normal system use. 
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Thus, this one change eliminates three errors flagged by the 
assembler; those at lines 12, 15, and 47. 

The next error occurs at line 32. Actually, the assembler 
flagged two errors here. An A error indicates an addressing 
problem and an R error indicates a register error (invalid use of 
a register, a special PDP-11 storage feature). If you look at the 
language statement in line 32, you can see that the ADD opera¬ 
tor is followed by one operand. However, ADD is an instruction 
that requires two operands (two values to be added together) 
separated by a comma. This statement simply contains a tjrping 
error, which can be corrected by inserting a comma between the 
R2 and the -2(R1). Thus, changing the line as follows both 
corrects the addressing problem and eliminates the invalid reg¬ 
ister expression: 

ADD R2t-2(R1) 

At line 41 is another undefined symbol, the macro symbol 
.TTYON. Since the program designated the macro symbol 
.TTYOUT in line 3, this error indicates a misspelling. Correct 
line 41 to read: 

.TTYOUT 

Finally, a D error occurs in line 54. This indicates that refer¬ 
ence was made to a symbol that is defined more than once. This 
error has already been eliminated as a result of the correction 
made to line 47. 

Thus, by changing the three lines indicated, you can correct all 
the errors flagged during assembly. So the next step is to edit 
the appropriate lines in the source program. If necessary, re¬ 
view the editing commands in Chapter 5, and then edit the file 
SUM.MAC on your system volume so that the three lines indi¬ 
cated are error-free. Do not rename the file. When you are 
ready, reassemble the program, using the MACRO command, 
and obtain a new object module and a new listing. This time the 
program should assemble without error. If errors occur, you 
have not edited the program correctly. Compare listings and try 
to correct yoiu- errors, or go back to the beginning of this chap¬ 
ter and repeat the demonstration. 


The object module produced by the MACRO command may in 
itself be incomplete. It may need to be joined with other object 
modules or library files to form a complete functioning 
program,^ since all required object modules must be joined be¬ 
fore the program can work. 


^Chapters 12 and 13 give more information on linking files and using library 
files, respectively. 


LINKING OBJECT 
MODULES 
TOGETHER 
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Thus, you must next link the SUM object module with any 
other object modules it requires. However, the only file used by 
this program was the macro library file SYSMAC.SML, and it 
was used during assembly. So in this case, you do not need to 
join the SUM object module with any other modules. 

NOTE 

Some other MACRO-11 programs that you write later 
may reference system subroutines supplied in the sys¬ 
tem subroutine library, SYSLIB.OBJ. Programs that ref¬ 
erence these routines must be linked with the system 
subroutine library to satisfy external references. If SYS¬ 
LIB.OBJ is not present on your system volume, follow 
the guidelines in the section of Appendix B entitled Using 
the LINK Volume. 

Even though SYSLIB is not required for SUM.OBJ, you must 
still link the file. The link operation, in addition to joining ob¬ 
ject modules together, also assigns absolute memory addresses 
to the relative addresses calculated by the MACRO-11 assem¬ 
bler. Since the memory addresses of one object module must be 
relocated to accommodate addresses used in another object 
module, the link operation serves to resolve all address 
changes. The result of the link is a memory image load module, 
with all module links resolved and all absolute memory ad¬ 
dresses and storage information assigned (Figure 11-6). The 
memory image module, then, is actually a picture of what com¬ 
puter memory looks like just before program execution. 



LINK 


Figure 11-6 The Link Operation 

To link the object modules, use the LINK command. The system 
prompts you to enter the names of the input object modules to 
be linked together. You can omit typing the .OBJ file type in 
the command line since the LINK command assumes this file 
type for input. After you have entered the input information, 
the system begins linking the object module. You do not have to 
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specify an output file, since the system automatically assigns 
the file name of the first input file and a file type of .SAV to the 
output file. 

Long Command Format 

• LINKfiBi 

Files? SUM® 

Short Command Format 

• LINK SUM® 

Any messages printed inform you of error conditions discovered 
during the link operation (for example, if you fail to specify all 
the necessary input object modules). However, assuming you 
edited your source program correctly and that it assembled 
without error, it should also now link without error. 

A load module is one that you can run on the system. Unless 
your program contains logic errors that prevent it from running 
properly (errors that the system cannot always detect), running 
the .SAV version of your program should produce the results 
you intended. However, if logic errors exist within your pro¬ 
gram, running the program will produce either erroneous re¬ 
sults or none at all. If this is the case, you must study the 
source program, rework it, reedit it, then perform the assembly 
and link operations again. 


If your MACRO-11 program is error-free, running the .SAV 
version should produce the expected results. In this demonstra¬ 
tion, running the SUM.SAV file should produce a value on the 
terminal that is the constant E (2 followed by 70 digits). 

To execute the MACRO-11 demonstration program, use the 
monitor RUN command. You can omit typing the .SAV file 
type, since the RUN command assumes this file type. T 5 rpe the 
following, and note the results printed on the terminal: 

Long and Short Command Format 

•RUN SUM® 

THE MALUE OF E IS: 

2 . 5 /B 06 / 606237 . 23013 ia. 06525 / 130 aa 02755350 Z 5 . 7147773735274 A 745 A 05502 . 5 aa 

You can see that something is wrong. Slashes and periods ap¬ 
pear in the result, indicating that an error still exists some¬ 
where in the program. 

Programming errors, called "bugs,” can be difficult to find and 
fix. A debugging aid called ODT (On-line Debugging Tech¬ 
nique) is described in Chapter 14. You will use it to correct the 
program’s final error and to rerun the program. For now, how¬ 
ever, the error will be pointed out and explained. 


RUNNING THE 
MACRO-11 
PROGRAM 
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COMBINING 

OPERATIONS 


EXECUTE 


Look at line 40 in the assembly listing. Notice that the instruc¬ 
tion in this line converts a digit into the appropriate ASCII code 
before printing it on the terminal. To do this, the constant 10 is 
added into the value of the digit already stored in memory, and 
then the value is converted — via ’0, the ASCII code for 
0 — to an ASCII code that can be printed. Unless you ex¬ 
plicitly designate a value as decimal, however, the assembler 
assumes all values used in the program are octal. Therefore, it 
interprets the constant as lO(octal) or 8(decimal), and adds the 
wrong value every time. The conversion consequently causes 
the codes of the ASCII characters / and . to be used as results in 
some cases. The codes of other digits, while representing nu¬ 
meric values, are also off by two. To correct this error, you must 
insert a period after the 10 in line 40. The period instructs the 
assembler to accept the constant value 10 as a decimal value. 


To produce program results, you first assembled the 
MACRO-11 source program, SUM.MAC, then linked it, and 
finally ran the resulting .SAV file, SUM.SAV. You can combine 
these three operations using one monitor command, the EXE¬ 
CUTE command. 


NOTE 

In order to use the EXECUTE command, the following 
files must be present on your system volume: 

SUM.MAC 

MACRO.SAV 

LINK.SAV 

SYSLIB.OBJ 

The last file, SYSLIB.OBJ, is required only if the 
MACRO-11 program you need to link refers to routines 
that are contained in the system library. The program 
used in this demonstration, SUM.MAC, does not require 
SYSLIB.OBJ. 

The EXECUTE command instructs the system to select the ap¬ 
propriate language processor, then process, link, and run the 
program. There are several ways to establish which language 
processor the EXECUTE command invokes. One way is to spec¬ 
ify a language-name option, such as /MACRO, which invokes 
the MACRO-11 assembler. Another way is to omit the lan¬ 
guage-name option and explicitly specify the file type for the 
source file. The EXECUTE command then invokes the lan¬ 
guage processor that corresponds to that file t 5 q)e. Specifying 
the file SUM.MAC, for example, invokes the MACRO-11 as¬ 
sembler. A third way to establish the language processor is to 
let the system choose a file t 5 q)e of .MAC, .DBL, or .FOR for the 
source file you name. If, for example, you specify the file SUM, 
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the monitor searches device SY: (your system device) for the 
files SUM.MAC, SUM.DBL, and SUM.FOR, in that order. If it 
finds a file named SUM.MAC, it invokes the MACRO-11 as¬ 
sembler to process the file. For example, to combine the assem- 
ble-link-run operations you performed in this chapter, you use 
the following command: 

Long Command Format 

. EXECUTE® 

Files? SUM/LIST/CROSSREFERENCE® 

Short Command Format 

. EXECUTE SUM/LIST/CROSSREFERENCE® 

THE VALUE OF E IS: 

2.5/608/606237.230131 a.06525/130aa0Z755350Z5.71a7773735Z7aa7a5a05502.5aa 

Notice how you use the /LIST and /CROSSREFERENCE op¬ 
tions following the file name to request both an assembly and a 
cross-referenced listing. 


EXECUTE 

Combine the assemble-link-run operations into one com¬ 
mand. 

EXECUTE file/MACRO 

Combine the process-link-run operations into one command, 
and specify the input file to be a MACRO-11 file. 

EXECUTE/CROSSREFERENCE 

Produce a cross-referenced listing file. 

EXECUTE/LIST 

Produce a listing file of the source program. 

LINK 

Link individual object modules together to form a complete 
program and produce a load module. 

MACRO 

Assemble the MACRO-11 source program, and produce an 
object module. 

MACRO/CROSSREFERENCE 

Assemble the MACRO-11 source program, and produce both 
an object module and a cross-referenced listing file. 

MACRO/LIST 

Assemble the MACRO-11 source program, and produce both 
a listing on the line printer and an object module. 

RUN 

Run the indicated load module. 


SUMMARY: 
COMMANDS TO 
RUN MACRO-11 
PROGRAMS 
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FILE MAINTENANCE 


Before continuing, you should perform the necessary file main¬ 
tenance operations. Obtain a directory of all files on your sys¬ 
tem volume that have the name SUM, regardless of file type; 
these files were created as a result of the exercises in this chap¬ 
ter. 

Long and Short Command Format 

. DIRECTORY SUM.*® 


08-Jan-83 
SUM .BAK 

3 

08-Jan-83 

SUM 

♦ SAU 

2 

08-Jan-83 

SUM 

♦ LST 

9 

08-Jan-83 

SUM 

♦ MAC 

3 

08-Jan-83 

SUM 

♦ OBJ 

1 

08-Jan-83 






5 Files# 18 BlocKs 
480 Free blocKs 

The fact that you have corrected errors in the source file of 
SUM.MAC makes the version of that file on your storage vol¬ 
ume obsolete. Therefore, transfer the updated copy from your 
system volume back to VOL:, replacing the copy of SUM.MAC 
on the storage volume with the new version. 


Long Command Format 

. COPY® 

From? SUM.MAC® 

To ? UOLrSUM.MAC® 

Short Command Format 

. COPY SUM.MAC OOLrSUM.MAC® 

Similarly, transfer SUM.SAV and SUM.OBJ to your storage 
volume. This allows you to rerun the MACRO-11 program 
without reassembling and relinking the source. 


Long Command Format 

. COPY® 

From? SUM.SAU »SUM.0BJ® 

To ? UOL;® 

Files copied: 

DK:SUM.SAM to OOLrSUM.SAV 
0K:SUM.0BJ to 00L:SUM.0BJ 


Short Command Format 

. COPY SUM.SAU .SUM.OBJ VOL:® 
Files copied: 

DK:SUM.SAV to VOL:SUM.SAV 
DK:SUM.0BJ to V0L:SUM.0BJ 


Once you have transferred to your storage volume the files you 
want saved, delete from the system volume those you no longer 
need (that is, all the SUM files). 
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Long Command Format 

, DELETE/NOOUERY® 

Files? SUM<e®) 

Short Command Format 

, DELETE/NOOUERY SUM.#® 


Notice that the /NOQUERY option suppresses confirmation 
when wildcard construction is used. 

Finally, obtain an up-to-date directory listing of your storage 
volume so that you can see its current status. 


Long and Short Command Formats 


, DIRECTORY UOL:® 

08-Jan-83 

SUM .SAU 2 08-Jan-83 

EXAMP .FOR 2 26-Au3-82 

GRAPH .FOR 2 08-Jan-83 

GRAPH .OBJ 16 08-Jan-83 

SUM .MAC 3 08-Jan-83 

10 Files. 81 Blocks 
4701 Free blocks 


SUM 

♦ OBJ 

1 

08-Jan-83 

EXAMP 

♦ MAC 

3 

2B-ALIS-82 

GRAPH 

♦ LST 

8 

08-Jan-83 

GRAPH 

♦ SAU 

21 

08-Jan-83 

MATCH 

♦ BAS 

3 

08-Jan-83 


This completes the MACRO-11 demonstration. Continue now 
to Chapter 12 to learn more about the link operation. 


PDP-11 MACRO-11 Language Reference Manual (AA-5075C-TC). Maynard, 
Mass.: Digital Equipment Corporation, 1983. 

A reference manual for the PDP-11 programmer using the MACRO-11 
assembly language. 

PDP-11 Peripherals Handbook. Maynard, Mass.: Digital Equipment Corpora¬ 
tion, 1981—82. 

A technical description of the PDP-11 peripheral devices, including nec¬ 
essary programming information. 

PDP-11 Processor Handbook. Maynard, Mass.: Digital Equipment Corpora¬ 
tion, 1981. 

A technical description of the various PDP-11 processors, including 
complete information concerning the PDP-11 instruction set. 

PDP-11 Programming Card. Maynard, Mass.: Digital Equipment Corpora¬ 
tion, 1975. 

A pocket-sized folding card summary of PDP-11 machine instructions 
used by the various PDP-11 assembly language processors. 

PDP-11 Software Handbook (EB-21759-20). Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1982-83. 

A general overview and introduction to available PDP-11 software, op¬ 
eration systems, and language processors. 
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CHAPTER 12 
LINKING OBJECT PROGRAMS 

Programs that you write in the MACRO-11 and FORTRAN IV 
programming languages require additional processing after 
their conversion to object format. Before you can run these pro¬ 
grams on the system, you must link them. The link operation: 

• Joins together the object modules that use a symbol with the 
object module that defines it. 

• Relocates individual object modules as necessary and assigns 
absolute (permanent) memory addresses; it can also define an 
overlay structure. 

• Produces a load module and an optional load map (Figure 
12 - 1 ). 



Figure 12-1 Link Functions 

Program linking gives you the advantage of a modular ap¬ 
proach to programming. You can create an entire program as a 
series of smaller, independent subprograms. One of these is 
written as the main, or controlling, program, and the rest as 
subordinate subprograms and subroutines. You use a language 
processor to translate each part of the program into an object 
module. Then you use the linker to join all the object modules 
together into a complete, functioning unit. 

Modular programming makes program creation and debugging 
easier. For example, several programmers can simultaneously 
work on a single program, each creating a portion of it. The 
individual portions, or subprograms, can be processed and 
linked with test programs and debugged for logic errors sepa¬ 
rately. Then all the object modules can be joined together to 
form a complete program that can be tested as a whole. If errors 
occur at this stage, only those object modules with errors need 
be debugged and changed. 
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In addition, modular programming allows you to make use of 
library files. These are files containing subprograms and sub¬ 
routines that have been debugged. After you join library files 
with your program at link-time, their routines can be used by 
your program as needed. 


RESOLVING 
SYMBOLIC AND 
LIBRARY 
REFERENCES 


The linker reads through all the object modules that you indi¬ 
cate as input to the LINK command. It gathers and evaluates 
information (provided to the modules by the language proc¬ 
essor) that is necessary for program linking. For each input 
module, this information includes the object code, information 
needed for relocation, the relative address of the first instruc¬ 
tion, the global symbols used, and the absolute length of each 
program and program section. 

One of the linker’s first functions is to resolve all user-defined 
symbolic references and library references in the joined 
routines. There are two types of user-defined symbols — in¬ 
ternal symbols and global symbols. 

Internal symbols are limited to the object module in which they 
appear; thus, they cannot be referenced from or defined in any 
other module. A program containing only internal symbolic 
references — like those in the demonstration program in 
Chapter 11 — is complete in itself and does not need to be 
joined with any other object programs at link-time. Thus, in¬ 
ternal symbols are not resolved at link-time because they have 
already been resolved by the language processor. 

Global symbols, on the other hand, are the key to modular pro¬ 
gramming. Global symbols provide the communication between 
object modules. Such symbols may be symbolic labels to instruc¬ 
tions, symbolic labels to data, or symbols that are equated to a 
value or constant. Global symbols are defined in one object 
module and referenced from other object modules that have 
been separately assembled or compiled. Such symbols must be 
designated as global in the source code. The following segment 
of MACRO-11 assembly language code illustrates the use of 
global symbols: 

.MAIN. HACRO 003.00 SATURDAY Oe-JAN-83 0Bi42 PAGE 1 

2 

3 

4 
3 
6 

7 

8 
8 

AU 10 
11 
12 

13 

14 
13 
16 

17 

18 


000000 013300 


000002 016701 000016 


000006 

000014 

000016 

000020 

000022 

000024 


.CLOBL A.C.UALUE 
NOV 8(R3)«.R0 


000000 000007 

013301 

003003 

000207 

000011 

177777 

000001 


USR 


PC.C 


VALUE I 
LOCAL I 


NOV f(R3)-^.Rl 

CLR R3 

RTS PC 

.WORD 11 

.UORD 177777 
.END 


lOECLARE A. C. AND VALUE 
IAS GLOBAL SYHBOLS 
{GLOBAL SYHBOL A IS DEFINED 
IHERE ANO CAN BE REFERENCED 
IFROH OTHER NODULES. PROBABLY 
IBY A SUBROUTINE CALL 
ILOCAL IS AN INTERNAL SYMBOL 
{DEFINED ANO REFERENCED ONLY 
IHITHIN THIS NOOULE 
{CALL TO GLOBAL ROUTINE C. 
{DEFINED IN ANOTHER NOOULE 


{GLOBAL SYNBOL VALUE IS USED TO 
{REFERENCE THIS DATA LOCATION 
{INTERNAL SYNBOL USED FOR OATA 
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While internal symbolic references, such as LOCAL in the ex¬ 
ample, can be resolved by the assembler or compiler within the 
single program unit, global references, such as C, cannot. They 
require other object modules. During translation, the language 
processor notes in the object module those symbols that are 
global. During linking, the linker keeps track of the global ref¬ 
erences and definitions found in all the object modules. As 
^iiiking proceeds, it makes the appropriate correlations and 
modifies instructions or data as necessary. After linking, the 
linker prints on the terminal a list of all symbolic references 
that were not resolved (undefined globals), either because of a 
programming error or because all necessary object modules 
were not included in the linking process. 

References to library files also involve the use of global sym¬ 
bols. You access the routines in a library by naming a routine 
as a global symbol in the source code of your program. You then 
link your program with the appropriate library file, and the 
linker resolves the library references just as it does any global 
symbol. Library usage is discussed in greater detail in Chapter 


A second important function of the linker is to "fix” the relative 
memory addresses so that they are absolute.' The object module 
represents translated source instructions that have been as¬ 
signed memory addresses relative to a base address of 0. 

Look back at the assembly listing in Chapter 11. Note the 
second column; these addresses are relative to a base address of 
0. Thus the first instruction is assembled at relative address 0, 
the second at relative address 6, and so on. A program cannot 
actually be stored and run in memory using locations relative 
to address 0, however, because system information is already 
stored in some of these locations. For example, the RT-11 oper¬ 
ating system uses byte addresses 40 through 57 to store infor¬ 
mation about the program currently executing. In addition, the 
RT-11 operating system uses locations in the upper range of 
memory for storing the resident monitor. Thus, the linker must 
assign memory addresses to your program that are not already 
in use or that will not be used during program execution. It 
must, therefore, assign absolute memory addresses to the rela¬ 
tive addresses assigned by the language processor. 

The linker normally starts assigning memory addresses at ad¬ 
dress 1000, since this begins a large section of free memory 

FORTRAN IV and BASIC—11 users who have not performed the demonstra¬ 
tion in Chapter 11 may wish to read the section in that chapter entitled The 
MACRO-11 Language Processor. That section explains the concept of con¬ 
verting and storing instructions in computer memory. 


PROGRAM 
RELOCATION 
AND ADDRESS 
ASSIGNMENT 
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ABSOLUTE AND 
RELOCATABLE 
PROGRAM SECTIONS 


space. So, to obtain the actual addresses used for program 
loading, you must add the relocation constant 1000 to each rela¬ 
tive address shown in the assembly listing. 


A conflict arises when several individually processed object 
modules are linked together. The linker cannot assign memory 
addresses starting at 1000 to every module, since address as¬ 
signments of one would then override those of another. How¬ 
ever, part of the information that the language processor calcu¬ 
lates and passes to the linker is the size of each program section 
in each module. So the linker simply adds this size into the 
relocation constant for each module and assigns higher ad¬ 
dresses, appropriately modifying the relative location of all in¬ 
structions and data as necessary to account for the relocation of 
each individual module. Figure 12-2 illustrates the relocation 
that must occur to accommodate object modules linked 
together.' 


370 




166 



372 (octal) 
bytes 


42 (octal) 
bytes 


170 (octal) 
bytes 


Relative addresses of three 
assembled/compiled programs 


0 


1000 


1370 

1372 

1432 

1434 


1622 

1624 


RESERVED 


PROG 


SUBONE 


SUBTWO 


I 

I 

I 

i 


I 

I 

I 


Absolute addresses of three 
linked programs 


Figure 12-2 Object Module Relocation 


Just as global symbols allow you to create an entire program, 
using several individual object modules, program sections allow 
you to create an object module as a series of individual sections. 
The advantages gained through the sectioning of programs re¬ 
late primarily to control of memory allocation, program modu- 

'A load map for this relocation example is shown later in the chapter. 
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larity, and more effective partitioning of memory. The linker 
processes the program section information in the object mod¬ 
ules as directions on how to create the executable program 
image. 

The FORTRAN IV and MACRO—11 language processors insert 
program sectioning information into the object module. The 
FORTRAN IV language processor does this automatically when 
program sectioning is implied by the source language state¬ 
ments in a user program. For example, FUNCTION, SUBROU¬ 
TINE, and COMMON statements result in the production of 
program section directives. In MACRO-11 assembly language, 
you are responsible for explicitly directing the assembler to 
output program section information for the linker. You do this 
through the .PSECT (or .CSECT and .ASECT) MACRO-11 as¬ 
sembly language statement. 

Some of the basic functions associated with program sections 
are: 

1. Instructions or data can be placed in absolute locations in 
memory. The named absolute program section (. ABS.) al¬ 
lows you to instruct the linker as to exactly where to place 
program code or data. Declaring a section as part of the 
absolute program section instructs the assembler or com¬ 
piler to use the internal value of the program counter as the 
physical memory address to be assigned after linking. This 
section is processed relative to absolute memory address 0 
and is not relocated at link time. 

2. Named relocatable program sections are used to group data 
or instructions into logical portions of memory. The FOR¬ 
TRAN IV COMMON statement invokes this construct to 
allow access to named data areas from many separate 
routines. Declaring a section as part of a named relocatable 
program section causes the section to be processed at relo¬ 
catable address 0. Such sections are relocated by the li nk er 

3. If you do not care about having exact control over where a 
portion (section) of a program will be placed in memory, use 
the blank program section — a special program section that 
the linker treats as relocatable. The linker decides where to 
place this program section in the loadable memory image. 
The blank program section is the default for a MACRO-11 
source program and remains in effect until an explicit pro¬ 
gram section is identified (the program example in Chapter 
11 used the blank program section). 

4. A program section can be identified as an instruction sec¬ 
tion. The linker, using this information, can provide auto¬ 
matic loading of declared overlay code when needed by the 
executing program (this will be discussed in more detail). 
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The Overlay Feature 


The language processor, then, actually maintains several pro¬ 
gram counters — one for the absolute program section, one for 
the unnamed relocatable program section, and as many as 
needed (maximum is 254) for named relocatable program sec¬ 
tions. The assembled example that follows helps explain this 
concept. 


.HAIN. MACRO W05.00- SATURDAY 08-JAN-83 OSiOA PACE I 


2 

3 

4 000000 OOSOOO 

5 000002 012701 

6 000006 062100 

7 000010 022701 

8 000014 100374 

8 000016 012767 

10 000024 009003 

11 000000 

12 000000 012703 

13 000004 012701 

14 000010 009021 

19 000012 009303 

16 000014 001379 

17 000000 

18 000042 

18 000042 001000 

20 
21 

22 000026 

23 000026 009267 

24 000032 000000 

29 000034 000001 

000042 000004 

26 000044 000000 

27 
26 

28 

30 000001 


000034' 

000044' 

002000 000020 

000100 

000044' 


STARTi 

LOOP* 


AGAIN* 


CUR RO 

MOV aBECiRl 

ADD (RD^tRO 

CMP liBEG^lOiRl 

BPL LOOP 

MOV *12000. AODR 

CLR R3 

.PSECT CLEAR 
MOV alOOtRO 

MOV iiADOR.Rl 

CLR (RD* 

DEC R3 

BNE AGAIN 

.ASECT 
.>42 

.UORD 1000 


000012 

000002 000003 BEG* 


.PSECT 

INC AOOR 
HALT 

.WORD 1.2>3 >4 


lUNNAMED RELOCATABLE PROGRAM 
ISECTION IS DECLARED (BY DEFAULT) 
I (-.PSECT* IS ASSUMED) 


(NAMED RELOCATABLE PROGRAM 

ISECTION IS DECLARED (VIA “.PSECT NAME*) 


(ABSOLUTE PROGRAM SECTION 
(DECLARED (VIA “.ASECT*) 

(THE VALUE 1000 HILL BE 

(STORED IN ABSOLUTE MEMORY LOCATIN 42 

(WHEN THE PROGRAM IS EXECUTED 

(BACK TO UNNAMED RELOCATABLE 

(PROGRAM SECTION 


AODR* .WORD 0 

(NOTE THAT YOU CAN HRITE LANGUAGE STATEMENTS THAT HILL BE LOADED 
(CONTIGUOUSLY IN MEMORY. BUT 00 NOT NECESSARILY OCCUR CONTIGUOUSLY 
(IN THE SOURCE PROGRAM (I.E.. THE CODE AT LINES 1-10 AND 22-28) 
.END 


Since the system does not know at assembly (or compile) time 
into which actual memory locations each relocatable section 
goes, all references among sections (see line 18) are relative to 
the base of the section. This information is then passed to the 
linker so that it can make the appropriate adjustments at link¬ 
time. 


The RT-11 linker is also capable of handling the special reloca¬ 
tion and address assignments that are required whenever you 
indicate that an overlay structure is needed. An overlay struc¬ 
ture is necessary when you write a program that is too large to 
fit in the available memory of your system. You write the pro¬ 
gram in discrete parts (some programming restrictions must be 
observed) so that your program can subsequently be executed in 
parts. Some of these parts, or segments, are allowed to share 
memory with other segments, thus reducing the overall 
memory requirements of the program. One segment of the pro¬ 
gram is called the root segment and must remain in memory at 
all times. The root segment contains the necessary information 
for use by the other segments of the program, called overlay 
segments. Overlay segments are stored on storage volumes and 
brought into memory as needed. The purpose of the overlay 
structure is for parts of the program to share the available 
memory in such a way that when one part is complete, it is 
overlaid (and therefore erased) by another. 

You indicate how to plan to overlay your program by using the 
/PROMPT option in the LINK command line. The linker then 
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creates a load module that contains the necessary information 
for loading the appropriate segments as needed during execu¬ 
tion. The RT—11 System Utilities Manual explains the overlay 
feature in more detail. You need not specify an overlay struc¬ 
ture for the examples demonstrated in this chapter. 


The load module is the result of the linking processes described 
so far: joining object modules, resolving symbolic and library 
references, relocating object modules, assigning absolute ad¬ 
dresses, and creating an overlay structime if required. The load 
map is essentially a synopsis of the load module — that is, what 
memory looks like when the program is loaded and ready to be 
executed. 

In Chapters 9 and 11, you produced load modules, but you did 
not request load maps. You obtain a load map by using the 
/MAP option with the LINK (or EXECUTE) command. At this 
time, relink the FORTRAN IV or MACRO-11 object module 
that you stored on VOL: and use the /MAP option to produce a 
load map.^ The load map is created as a file on the system 
volume, which is the default storage volume for input/output 
operations. The load map has the name of the first input 
module and a file t 3 q)e of .MAP. 

Long Command Format 
MACRO-11 object module: 

.LINK® 

Files? OOL;SUM/MAP® 


FORTRAN IV object module, if FORLIB is not included in 
SYSLIB: 


, LINK® 

Files? SYSLIB .FORLIB .OOL : GRAPH/MAP® 


FORTRAN rV object module, if FORLIB is included in SYSLIB: 

, LINK® 

Files? OOLsGRAPH/MAP® 


Short Command Format 
MACRO-11 object module: 

. LINK yOL:SUM/MAP® 


FORTRAN rV users who followed the special instructions in Appendix B for 
loading the LINK volume should check that this volume is loaded in device 
unit 0. FORTRAN IV users who have a special FORTRAN IV language vol¬ 
ume, but not a LINK volume, should make sure that the FORTRAN IV vol¬ 
ume is now loaded in device unit 0. 


PRODUCING 
A LOAD MODULE 
AND A LOAD MAP 


/MAP 
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FORTRAN IV object module, if FORLIB is not included in 
SYSLIB: 

. LINK SYSLI8 »FORLIB tVOL:GRAPH/MAP® 

FORTRAN IV object module, if FORLIB is included in SYSLIB: 

. LINK VOL:GRAPH/MAP® 


Now list the .MAP file on either the line printer or terminal, 
choosing the appropriate command: 

Long Command Format 

(Line printer) (Terminal) 

MACRO-11 object module: 

. PRINT® • TYPE® 

Files? SUM.MAP® Files? SUM.MAP® 

FORTRAN IV object module: 


. PRINT® • TYPE® 

Files? GRAPH.MAP® Files? GRAPH.MAP® 


Short Command Format 

(Line printer) (Terminal) 

MACRO-11 object module: 

. PRINT SUM.MAP® • TYPE SUM.MAP® 

FORTRAN IV object module: 

. PRINT GRAPH.MAP® • TYPE GRAPH.MAP® 


For your convenience, both maps are provided here. In addition, 
a load map of the relocation example used in Figure 12-2 is also 
provided. 

Rj-ll LINK VO0.OO Load Map Saturdaw 08-j3ri-83 10.00 Fade 1 


SUM eSAU 

Title * 

SUM.MA 

Ident: 





Section 

Addr 

Size 

Global 

Ualue 

Global 

Ualue 

Global 

Ualue 

• ABSe 

000000 

001000 

= 256. 

words 

(RUrlfGBL 

fABS»OUR) 



001000 

000372 

* 125. 

words 

(RUfIfLCL 

fRELfCON) 


T ransfer 

address ~ OOlOOOv Hidh 

limit = 

: 001370 = 

380. 

words 


RT-11 LINK U08. 

,00 

Load Map 

Saturdaw 

08-~Jan- 

-83 io:ii 

Pasle 

SYSLIB.SAU 

Title: 

.MAIN. 

Ident: 

F0R002 




Section 

Addr 

Size 

Global 

Ualue 

Global 

Ualue 

Global 

Ualue 

• ABS* 

000000 

001000 

* 256. 

words 

(RUrIrGBL 

»ABSrOUR) 





iUSRSU 

000000 

$RF2A1 

000000 

$HRDWR 

000000 




.VIR 

000000 

♦NLCHN 

000006 

♦SYSU$ 

000012 




$UASIZ 

000152 

$LRECL 

000210 

♦TRACE 

004737 
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OTSil 

001000 017722 = 4073* 

words 

<RW,I,LCLfREL»CON) 



$$0TSI 

001000 

♦CVTIF 

001000 

♦CVTIC 

001014 


♦COTID 

001014 

CCI$ 

001026 

CDI^ 

001026 


♦ IC 

001026 

$ID 

001026 

CFI^ 

001042 


♦ IR 

001042 

EXP 

001126 

ADF^IS 

001466 


ADF$PS 

001474 

SUF$PS 

001500 

SUF^MS 

001504 


ADF$MS 

001516 

SUF$IS 

001526 

♦ ADDF 

001534 


♦ SUBF 

001550 

SUF$SS 

001562 

♦ SBR 

001562 


ADF$SS 

001566 

♦ADR 

001566 

ADD^ 

001602 


DIFtPS 

002226 

DIF$MS 

002232 

DIF^IS 

002242 


$DI0F 

002250 

DIF$SS 

002262 

♦ DOR 

002262 


MUF$PS 

002550 

MUF$MS 

002554 

MUFTIS 

002564 


$MULF 

002572 

MUF$SS 

002604 

♦MLR 

002604 


$0TI 

003142 

♦ ♦OTI 

003144 

♦SETOP 

003354 


$$SET 

005026 

SORT 

005322 

STK^L 

005516 


STK$I 

005522 

STK$F 

005526 

IGR^ 

005536 


AND$ 

005542 

EQO$ 

005550 

XOR^ 

005552 


NMI$1M 

005566 

NMI$1I 

005600 

BLE^ 

005610 


BEQ$ 

005612 

BGT$ 

005620 

BGE^ 

005622 


BRA$ 

005624 

BNE$ 

005630 

BLT^ 

005632 


CAI$ 

005642 

CAL$ 

005650 

END^ 

005700 


ERR$ 

005712 

♦END 

005724 

♦ERR 

005742 


♦OPNER 

005764 

♦CHKER 

006022 

♦lOEXI 

006046 


♦EOL 

006114 

EOL^ 

006116 

EXIT 

006232 


MOFiSS 

006236 

MOF^MS 

006250 

MOF^PS 

006262 


MOF$SM 

006266 

MOF^SP 

006276 

MOF^MM 

006302 


MOF$MA 

006314 

MOF^MP 

006322 

MOF^PM 

006330 


MOFiPA 

006334 

MOF^PP 

006340 

MOF^RS 

006344 


MOF$RM 

006352 

MOF^RA 

006362 

MOF^RP 

006366 


NGD$S 

006372 

NGF^S 

006372 

NGD^M 

006404 


NGFiM 

006404 

NGD^P 

006420 

NGF^P 

006420 


NGD$A 

006424 

NGF^A 

006424 

ADI^SS 

006430 


ADI$SA 

006434 

ADI^SM 

006440 

ADI^IS 

006444 


ADI$IA 

006450 

ADI^IM 

006454 

ADI♦MS 

006460 


ADIiMA 

006464 

ADI♦MM 

006470 

CMI^SS 

006474 


CMI$SI 

006500 

CMI^SM 

006504 

CMI^IS 

006510 


CMIill 

006514 

CMI^IM 

006520 

CMI^MS 

006524 


CMIiMI 

006530 

CMI^MM 

006534 

IFW^ 

006540 


$IFW 

006544 

♦♦IFW 

006550 

IFU^^ 

006606 


MOI$RS 

006656 

MOLARS 

006656 

MOI^RM 

006662 


MOI$RP 

006666 

MOI^RA 

006670 

MOI^SS 

006674 


MOL$SS 

006674 

MOI^SM 

006700 

MOI^SA 

006704 


MOIilS 

006710 

MOLLIS 

006710 

REL^ 

006710 


MOI$IM 

006714 

MOI^IA 

006720 

MOI^MS 

006724 


MOIiMM 

006730 

MOI^MA 

006734 

MOI^OS 

006740 


MOI$OM 

006744 

MOI^OA 

006750 

MOI^lS 

006754 


M0I$1M 

006762 

MOI^IA 

006770 

ICI^S 

006776 


ICI$M 

007002 

ICI^P 

007006 

ICI^A 

007010 


DCI$S 

007014 

DCI^M 

007020 

DCI^P 

007024 


DCI$A 

007026 

IDINT 

007032 

INT 

007032 


MOI$IP 

007060 

MOI^SP 

007062 

MOI^PP 

007070 
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SYSLIB.SAV Title: ♦MAIN* Ident: F0RV02 


MOI^MP 

007074 

MOI♦PS 

007104 

MOI♦PM 

007112 

MOI♦PA 

007120 

MOI^OP 

007126 

MOI^IP 

007134 

ISN^ 

007144 

♦ISNTR 

007150 

LSN^ 

007164 

♦LSNTR 

007170 

SUI^SS 

007324 

SUI^SA 

007330 

SUI^SM 

007334 

SUI^IS 

007340 

SUI^IA 

007344 

SUI^IM 

007350 

SUI^MS 

007354 

SUI^MA 

007360 

SUI^MM 

007364 

MOL^SM 

007370 

MOL^SA 

007374 

MOL^MS 

007400 

MOL^MM 

007410 

MOL^MA 

007414 

MOL^SP 

007420 

MOL^PP 

007426 

MOL^MP 

007432 

MOL^PM 

007442 

MOL^PS 

007450 

MOL^PA 

007454 

MOL^IM 

007462 

MOL^IA 

007470 

MOL^IP 

007476 

LLE^ 

007506 

LEQ^ 

007510 

LGT^ 

007516 

LGE^ 

007520 

LNE^ 

007530 

LLT^ 

007532 

TSL^S 

007536 

TSL^M 

007542 

TSL^I 

007546 

TSL^P 

007554 

MAXO 

007562 

MINO 

007606 

RET^L 

007632 

RET^F 

007636 

RET^I 

007644 

RET^ 

007646 

♦OTIS 

007702 

♦♦OTIS 

007704 

TOL^ 

010024 

♦ TVL 

010024 

TVF^ 

010032 

♦ TOF 

010032 

TOD^ 

010040 

♦ TOD 

010040 

TOQ^ 

010046 

♦ TOO 

010046 

TOP^ 

010054 

♦ TOP 

010054 

TVI^ 

010062 

♦TOI 

010062 

SAL^IM 

010216 

SAL^SM 

010220 

SVL^IM 

010224 

SVL^SM 

010226 

SAL^MM 

010234 

SVL^MM 

010240 

SAL^IP 

010244 

SAL^SP 

010246 

SOL^IP 

010252 

SUL^SP 

010254 

SAL^MP 

010262 

SOL^MP 

010266 

♦COTFB 

010272 

♦CVTFI 

010272 

♦COTCB 

010306 

♦COTCI 

010306 

♦CVTDB 

010306 

♦CVTDI 

010306 

CIC^ 

010320 

CID^ 

010320 

CLC^ 

010320 

CLD^ 

010320 

♦ DI 

010320 

CIF^ 

010330 

CLF^ 

010330 

♦ RI 

010330 

CIL^ 

010442 

CLI^ 

010446 

♦INITI 

010450 

♦CLOSE 

010566 

♦ERRTB 

011344 

♦ERRS 

011451 

♦FCHNL 

015212 
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♦FIO 

016054 

♦♦FIO 016060 ♦PUTRE 

017224 



♦PUTBL 

017532 

♦GETBL 017742 SEOFIL 

020126 



♦EQF2 

020142 

SAyRG$ 020162 THRD$ 

020340 



♦STPS 

020342 

STP$ 020350 ♦STP 

020350 



F00$ 

020354 

♦EXIT 020374 ♦WAIT 

020520 



♦ORINT 

020562 

♦DUhPL 020574 


OTSfP 

020722 

000054 = 22* 

words 

<RWrD,GBLrREL»OOR) 


SYSil 

020776 

000244 = 82* 

words 

(RWrIfLCLfREL»CON) 




LEN 

020776 

REPEAT 021014 SCOPY 

021146 

USER$I 

021242 

000000 = 0* 

words 

(RWfIfLCLfRELrCON) 


iCODE 

021242 

001316 = 359* 

words 

<RW»IfLCLrRELfCON) 




♦♦OTSC 

021242 

FUN 022120 PUTSTR 

022266 

OTSiO 

022560 

001036 = 271* 

words 

(RWfIrLCLfRELfCON) 




♦♦OTSO 

022560 

♦OPEN 022560 


SYSiO 

023616 

000000 = 0* 

words 

(RWfIfLCL»REL»CON) 


♦DATAP 

023616 

000106 = 35* 

words 

(RW»D»LCLfRELfCON) 


OTSfD 

023724 

000006 3* 

words 

(RWfD»LCL»RELFCON) 




NHCLNi 

023730 



OTSiS 

023732 

000002 = 1* 

words 

(RWrDFLCLfRELfCON) 




♦AOTS 

023732 



SYSiS 

023734 

000004 == 2* 

words 

(RUfDfLCLfRELfCON) 




♦SYSLB 

023734 

♦LOCK 023736 ♦CRASH 

023737 

♦DATA 

023740 

000536 = 175* 

words 

(RWfDfLCLfRELfCON) 


USER«D 

024476 

000000 = 0* 

words 

(RUrDfLCLFRELrCON) 



024476 

000000 = 0* 

words 

(RWfDfGBL»REL»OVR) 


RT-11 LINK V08 

*00 Load hap 

Saturday 08-Jari-83 10: 

11 Pade 

SYSLIB* 

SAO 

Title: *MAIN* 

Ident* 

F0RV02 



T ransfer 

address = 0212 

42» Hidh 

limit = 

024474 = 5278* 

words 


RT~11 LINK 008. 
TEST *SAV 

00 

Title: 

Load hap 
*hAIN* Ident: 

Saturday 08-Jarr 

-83 lo: 

16 Pade 

Section 

Addr 

Size 

Global 

Oalue 

Global Value 

Global 

Value 

* ABS* 

000000 

001000 

001000 

000626 

= 256* 

= 203* 
PROG 

words 

words 

001000 

(RWfIfGBLfABSfOVR) 
(RWfIfLCLfRELfCON) 
SUBONE 001372 SUBTWO 

001434 


Transfer address = OOlOOOr Hidh limit ~ 001624 = 458* words 

The second line has the name and file type of the load module 
created. Next, the absolute section and each named and un¬ 
named section are listed under the SECTION column. To the 
right are abbreviated codes designating whether the section 
contains Instructions or Data, is Read/Write or Read Only, is a 
Local or Global section, is Relocatable or Absolute, is Concat¬ 
enated or Overlaid. Below this falls a listing of all the global 
symbols (GLOBAL) and their values (VALUE). Finally, at the 
end of the map is the transfer address where the program actu¬ 
ally starts when executed, followed by the high limit — the 
total number of bytes used by all the individual program sec¬ 
tions. 

Look first at the MACRO-11 load map. The default absolute 
section starts at absolute location 0; its size is 1000 bytes. Thus, 
it extends from absolute memory location 0 through absolute 
memory location 777. The unnamed program section (there 
were no named program sections in this program) starts at ab¬ 
solute 1000; its size is 372 b 5 d;es. Thus it extends from absolute 
location 1000 to absolute location 1370. The high limit of this 
program (total bytes) is therefore 1370. Since this program is 
not linked to any other object modules, there are no global sym¬ 
bols and the rest of the map is blank. 

Look now at the FORTRAN IV load map, remembering that it 
reflects the appropriate expansions into machine language code 
provided by the FORTRAN FV compiler. Again, the absolute 
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section extends from absolute 0 through absolute 777. Globals 
listed in the absolute section show the global variable names 
that the program uses as constants throughout the program. 

The unnamed relocatable program section begins at absolute 
location 1000. Some of the named relocatable sections that are 
declared are OTS$P, SYS$I, and $CODE. Global symbols and 
their respective addresses appear to the right of all sections. 
The total number of bytes used is 24474, or 5278(decimal) 
words. 

The third load map is for the program illustrated in Figure 
12-2. First, the map shows the absolute program section, la¬ 
beled .ABS. It extends from location 0 through location 777. 
Next, the map shows the unnamed program section, which be¬ 
gins at location 1000 and is 1624 bytes long. This program sec¬ 
tion consists of a main program, called PROG, and the sub¬ 
routines SUBONE and SUBTWO that were linked with PROG. 
Look again at Figure 12-2 to see how these routines fit into 
memory. The transfer, or starting, address is 1000, and the 
total number of bytes the program occupies is 1624, or 458(dec- 
imal) words. 

Load maps are most helpful when used in debugging to locate 
and correct assembly language programming errors. Load maps 
are not generally obtained or used for FORTRAN IV programs, 
except to determine program size. In Chapter 14 you will see 
how a load map is used to debug the one remaining error in the 
MACRO-11 demonstration program. 


LINK 

Link individual object modules together to form a complete 
program and to produce a load module. 

LINK/MAP 

Link individual object modules, and produce a load map 
showing all address assignments made during linking. 

NOTE 

FORTRAN IV users who followed the special instruc¬ 
tions in Appendix B to load the language or LINK volume 
should now stop the system, unload that volume, load 
the main system volume, and rebootstrap the system 
before going on to Chapter 13. 


RT-11 System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-11 system utilities. 


SUMMARY: 
COMMANDS 
FOR LINKING 
PROGRAMS 


REFERENCE 
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CHAPTER 13 
CONSTRUCTING LIBRARY FILES 


A library is a specially constructed file consisting of one or 
more programming routines. Generally, these routines provide 
services that you are apt to need repeatedly, or services that are 
related and so have been gathered together for ease in use and 
storage. You use the routines in a library by joining the library 
file with your source program. Usually this occurs at link-time: 
but in the case of assembly language programs, it may also 
occur at assembly-time. 

The RT-11 operating system provides several library files; 
SYSLIB and VTLIB for example. These libraries supply the 
monitor services, input and output routines, conversion 
routines, and other programming services that user programs 
may need. You can create other library files yourself. Thus you 
can construct libraries that contain routines specific to your 
programming needs or to the combined needs of those using 
your RT-11 system. 


There are two kinds of library files — macro libraries and ob- KINDS OF 

ject libraries. LIBRARY FILES 


Macro libraries, such as SYSMAC.SML, are used by Macro Libraries 

MACRO-11 source programs at assembly-time and consist en¬ 
tirely of macros. A macro is described in Chapter 11 as a recur¬ 
ring sequence of coding instructions, which, when defined in a 
.MACRO statement, can then be called and used anywhere in 
your program. A macro library is merely several macro defini¬ 
tions gathered together into a single file. To use the macros in a 
macro library, you simply name those macros you plan to use in 
a .MCALL statement. When the assembler encounters the 
.MCALL statement during processing, it searches the appropri¬ 
ate macro library (SYSMAC.SML is default) for the definitions. 

It takes the definitions from the library and inserts them in a 
special table called the macro symbol table where they become 
available for use during assembly. 

Object libraries, such as SYSLIB, are used by assembled Object Libraries 

MACRO-11 source programs and/or by compiled FORTRAN IV 
source programs at link-time. These libraries consist of object 
modules that contain global routines; such routines have been 
defined with global entry points and then named as global sym¬ 
bols in the source program. During the link operation, the 
linker searches the object libraries to determine if they provide 
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Constructing Library Files 


CREATING AND 
MAINTAINING 
A LIBRARY FILE 


Creating Object 
Library Input Files 


definitions for any undefined globals. If the linker finds defini¬ 
tions, it takes those object modules containing the definition 
from the library and includes them in the link. 

A special table, called the global symbol table, lists each global 
in a given object library. You can print this list on the terminal 
or the line printer and thus keep track of an object library’s 
cvirrent contents. 


You create a library file by combining several macro routines, 
or several object modules, into a single larger file using the 
monitor LIBRARY command. 

To build a macro library, first use the editor to create an ASCII 
text file that contains all the macro definitions. Then process 
this file using the LIBRARY command in combination with its 
/MACRO option. To update a macro library (that is, to add or 
delete macro definitions), simply edit the ASCII text file and 
then reprocess the file with the LIBRARY command. 

To build an object library, use the editor to create an ASCII text 
file. The file contains the routines and functions written as 
complete program segments in either the MACRO-11 assembly 
language or the FORTRAN IV programming language. Then 
process the file, producing an object module. Next, use the LI¬ 
BRARY command in combination with its /CREATE option. 
Once the library file is created, update it (add and delete 
routines) by means of various other options to the LIBRARY 
command. 

In the following exercises, you create an object library that con¬ 
tains three input object modules. The routines in two of these 
modules can be used by both MACRO-11 and FORTRAN IV 
programs; the routine in the third module can be used only by 
FORTRAN IV programs. 

To build the library file, first use the editor to create the three 
ASCII text files. Then convert the ASCII text files to object 
format. Filially, process the object files with the LIBRARY com¬ 
mand. Once you create the library files, use LIBRARY com¬ 
mand operations and options to add and delete modules and 
globals and to obtain a listing of the library file contents. 


The first step in building an object library is to prepare the 
source code of the routines and functions that you choose to 
include in the library. Use the editor to create the following 
three text files, calling them FIRST.MAC, SECOND.MAC, and 
THIRD.FOR, respectively. FORTRAN IV users should create 
all three files; MACRO-11 users (who do not use FORTRAN 
rV) should create only the first two files. 
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FIRST,MAC 



♦TITLE 

COMB 




♦MCALL 

♦ PRINT 



5 

I=LEN(A) 





♦GLOBL 

LEN 



LEN: 

TST 

(R5) + 

5SKIP 

« OF ARCS 


MOO 

@R5 ,R0 

;get 

STRING POINTER 

1$: 

TSTB 

(R0) + 

;find 

END OF STRING 


BNE 

1$ 

;loop 

UNTIL NULL BYTE 


DEC 

RO 

;back 

UP 


SUB 

@R5 ,R0 

5CALC 

« OF CHARS IN STRING 


RTS 

PC 



5 

CALL 

PRINK ISTRNG) 



♦GLOBL 

PRINT 



PRINT: 

MOO 

2(R5) ,R0 


;addr of istrng 


♦PRINT 


i.PRINT 


RTS 

PC 

;and I 

RETURN 


♦ END 


SECOND.MAC 


ITTOUR 


♦TITLE ITTOUR 
I=ITTOUR(ICHAR) 


1=0 
= 1 

♦MCALL 
♦GLOBL 
MOOB 
♦TTOUTR 
BIC 
ADC 
RTS 
♦ END 


CHARACTER HAS BEEN OUTPUT 
RING BUFFER IS FULL 
♦TTOUTR 
ITTOUR 

@2(R5)»R0 ;GET CHARACTER 

; .TTOUTR 

ROfRO ;CLEAR ERROR FLAG 

RO 

PC ;return 


THIRD.FOR 

C CALL PUTSTR(LUN ,AREAfCC) 

SUBROUTINE PUTSTR(LUN .AREA»CC) 

LOGICAL*! AREA(250) tCC 
IF(CC) GOTO 1 

WRITE (LUN f9S) (AREA(I) ,1 = 1 ,LEN(AREA)) 
RETURN 

1 WRITE (LUN ,9g)CC ,(AREA(I) ,1 = 1 ,LEN(AREA)) 

99 F0RMAT(250A1) 

END 


The routines in these files are representative of the kinds of 
services generally provided in a library file. They are, in fact, 
taken from the RT-11 system subroutine library, SYSLIB. 
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FIRST.MAC contains two global routines, LEN and PRINT. 
The LEN routine returns the number of characters in a string. 
PRINT outputs an ASCII string terminated with a zero byte to 
the terminal (it is the FORTRAN IV equivalent of the system 
macro .PRINT, used in the demonstration program in Chapter 
11). SECOND.MAC contains one global routine, ITTOUR, 
which transfers a character to the console terminal. 
THIRD.FOR also contains one global routine, PUTSTR. This 
routine can be used only by FORTRAN IV programs and writes 
a variable-length character string on a specified FORTRAN IV 
logical unit (see GRAPH example). 

Once you create these text files, the next step is to convert them 
from ASCII format to object format. Assemble or compile the 
text files as appropriate, first assembling FIRST.MAC and ob¬ 
taining an object module (a listing is not necessary). FORTRAN 
IV users who are not familiar with the assembly process simply 
type the MACRO commands as shown. 

Long Command Format 

• MACRO® 

Files? first® 

Short Command Format 

• MACRO FIRST® 

The command creates an object module called FIRST.OBJ on 
the system volume. If errors occur, the assembler prints a mes¬ 
sage on the terminal, indicating the number of errors encoun¬ 
tered during assembly. No errors should occur. 

In the same way, assemble SECOND.MAC. Again, no errors 
should occur. 

Long Command Format 

• MACRO® 

Files? SECOND® 

Short Command Format 

• MACRO SECOND® 

If any errors occur during the assembly operations, you have 
typed the source files incorrectly. Find and correct the typing 
errors, and reassemble. 

If you are a FORTRAN IV user, continue by compiling 
THIRD.FOR. 
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NOTE 

If in Chapter 9 you needed to load the special 
FORTRAN/BASIC language volume, you must again 
load that volume before you can compile THIRD.FOR. 
Read Appendix B, Substituting Volumes During Opera¬ 
tions, before continuing. 

Long Command Format 

, FORTRANiE) 

Files? THIRD® 

PUTSTR 

Short Command Format 

. FORTRAN THIRD® 

PUTSTR 

Notice that the compiler prints the name of the global 
(PUTSTR) generated. If any errors occur during the compile 
operation, you have typed the source file incorrectly. Find and 
correct the typing errrors, and recompile. 

Once you have produced the object modules, you are ready to 
build the object library file. 


Use the LIBRARY command in combination with its /CREATE 
option to construct a library file. You must indicate in the com¬ 
mand the name of the library file and the names of the input 
object modules. Call the library file LIBRA and specify as input 
the two object modules, FIRST and SECOND. The LIBRARY 
command assumes that the input modules have the .OBJ file 
type (unless you indicate otherwise) and automatically assigns 
.OBJ to the library file. 

Long Command Format 

.LIBRARY/CREATE® 

Library? LIBRA® 

Files ? FIRST .SECOND® 

Short Command Format 

.LIBRARY/CREATE LIBRA FIRST .SECOND® 

Once the CREATE operation is complete, obtain a listing of the 
library file’s contents, using the LIBRARY command with its 
LIST operation. The line printer is the assiimed output device 
for the list file, although you may indicate a different output 
device by adding the two-letter device mntimonic to the LIST 
option that follows. 


Building the 
Object Library 


LIBRARY/ 

CREATE 






Constructing Library Files 


LIBRARY/LIST 


Long Command Format 

(Line printer) (Terminal) 


* LIBRARY/LIST® • LIBRARY/LIST:TT:® 

Library? LIBRA® Library? LIBRA® 

Short Command Format 


(Line printer) (Terminal) 

• LIBRARY/LIST LIBRA® * LIBRARY/LIST;TT: LIBRA® 

The listing produced shows the library file’s current contents. 
This library has three entry points: LEN and PRINT in the first 
module, and ITTOUR in the second module. 


RT-ll LIBRARIAN 005.00 SAT 8-JAN-83 lls03:29 
DK:LIBRA.OBJ SAT 8-JAN-83 10;58:A3 

MODULE GLOBALS GLOBALS GLQBALS 


LEN PRINT 

ITTOUR 


Updating the 
Object Library 


LIBRARY/ 

INSERT 


Once you have created an object library, you use various LI¬ 
BRARY command operations to update and maintain it by 
adding and deleting modules and globals. 

If you created the THIRD.OBJ object module, you can add it to 
the library file using the INSERT option. If you did not create 
this module, read through this section anyway; the command 
steps apply to any object module you wish to insert. 

Long Command Format 

• LIBRARY/INSERT® 

Library? lIBRA® 

Files ? third® 

Short Command Format 

•LIBRARY/INSERT LIBRA THIRD® 

This operation inserts the object module contained in the file 
THIRD.OBJ, including all its globals, into the library file 
LIBRA. Obtain a listing of the library contents, using the LIST 
option, to verify that the new globals have been added. The 
listing should look like this: 

RT-ll LIBRARIAN 005.00 SAT 8-JAN-83 11:05:1 
DK:LIBRA.DBJ SAT 8-JAN-83 11:0A:21 

MODULE GLOBALS GLOBALS GLOBALS 

LEN PRINT 

ITTOUR 

PUTSTR 
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This listing shows the complete library file containing the glo- 
bals from all three modules. 

You can remove individual globals by using the REMOVE op¬ 
tion. For example, to remove the global ITTOUR, type: 

Long Command Format 

• LIBRARY/REMOMEdB) 

Library? LIBRABB 
Global? ITTOUR® 

Global? dg) 

Short Command Format 

• LIBRARY/REMOUE LIBRA® 

Global? ITTOUR® 

Global? ® 

The library file’s contents now look like this: 

RT-ll LIBRARIAN 005.00 SAT 8-JAN-83 11:10:22 
DK:LIBRA.OBJ SAT 8-JAN-83 11:10:05 

MODULE GLOBALS GLOBALS GLOBALS 

LEN PRINT 

PUTSTR 

These are some of the library maintenance operations that you 
can perform by using the LIBRARY command. Other library 
operations are available and are explained in the RT-ll 
System Utilities Manual. 


LIBRARY/MACRO 
Create a macro library. 

LIBRARY/CREATE 
Create an object library. 

LIBRARY/INSERT 

Insert object modules into the object library. 
LIBRARY/LIST[:filespec] 

List the current contents of an object library on the line 
printer; [:filespec] is an optional output file and/or device. 

LIBRARY/REMOVE 
Remove globals from the object library. 


Since all the object modules used in this chapter already exist 
as modules within the provided system library SYSLIB, there is 
no need to save them or the LIBRA library file. You can delete 
these object modules and their source files from your system 


Constructing Library Files 


LIBRARY/ 

REMOVE 


SUMMARY: 
COMMANDS FOR 
MAINTAINING 
LIBRARY FILES 


FILE MAINTENANCE 
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volume by using the DELETE command as follows (exclude 
THIRD.* from the command line if you did not create this file): 

Long Command Format 

. DELETE/NOOUERY® 

Files? FIRST.* .SECOND.* .THIRD.# .LIBRA.OBJ® 

Short Command Format 

,,DELETE/NOOUERY FIRST . * .SECOND . * .THIRD . * .LI BRA . OB J® 

FORTRAN IV users who performed the special instructions 
given in Appendix B should also delete the THIRD files from 
the storage volume. 

Long Command Format 

.DELETE/NOOUERY® 

Files? OQLiTHIRD.*® 

Short Command Format 

.DELETE/NOOUERY V0L:THIRD.*® 


REFERENCE 


RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-ll system utilities. 
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CHAPTER 14 
DEBUGGING A USER PROGRAM 


Debugging is the process of finding and fixing the programming 
errors that almost every user program initially contains. From 
your experience in Chapters 9, 10, and 11, you already know 
about some of the kinds of programming errors that can pre¬ 
vent a program from working properly when you run it on the 
system. 

Frequently, debugging a program requires more time and per¬ 
sistence than writing the program code requires. Therefore, you 
should anticipate the debugging process throughout the entire 
program development cycle. That is, you should follow some 
common programming practices that help you first to make as 
few programming errors as possible. When errors become ap¬ 
parent during the various phases of development, correct them 
immediately. Test the validity of any algorithms used within 
your program. Finally, even though the program appears to be 
working properly, check it thoroughly with test data. 


AVOIDING 

PROGRAMMING 

ERRORS 


Design the program. The technique of flowcharting the pro¬ 
gram and then correlating it with the program coding simpli¬ 
fies tracking the program logic and module interrelationships. 

Use modular programming. Create the program as a series of 
smaller, self-contained subprograms. Debug the program in 
parts. 

For frequently used functions, maximize the use of subroutines, 
subprograms, and — in the case of assembly language pro¬ 
grams — macros. These help to structure the program and 
make it easier to alter or to add features that may be required 
in the future. 

Make use of any software provided by the system, such as li¬ 
brary routines and functions. System software has already been 
debugged and can save you the trouble of re-creating the ser¬ 
vices. 

Make the general flow of a program proceed down the page. 
Avoid nonstructured branching and convoluted logic, as these 


You can take several steps to decrease the likelihood of intro¬ 
ducing errors into your program and to make debugging easier. 

First, always use a high-level language if one will suit your 
programming needs. High-level language programs tend to use 
fewer statements. English-like words and phrases in the lan¬ 
guage statements make the program logic easier to follow. 
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WHEN 

PROGRAMMING 
ERRORS OCCUR 


tend to produce programs that are difficult to debug. Finally, 
use comments liberally throughout the program to show what 
individual statements or groups of statements do. Use spaces 
and tabs in the program code to make it easier to read. 

Following these preventative steps eliminates many common 
programming errors and helps to create a programming style. 
However, even the most careful programmer may overlook a 
small detail: a typing error during program creation, an unde¬ 
fined label in the code, or some other programming bug. When 
something is overlooked, debugging becomes necessary. 


There are three general types of programming errors — syntax, 
clerical, and logical. 

Syntax errors are errors in the physical coding, such as omit¬ 
ting necessary portions of the statement (delimiters for ex¬ 
ample), reversing the order of information within the state¬ 
ment, or misspelling keywords or instructions. 

Clerical errors are non-syntax errors in the physical coding, 
such as mist 3 T)ed letters or digits in data. Clerical errors may 
result in valid statements that do not reflect correct program¬ 
ming logic. 

Logical errors are errors made in program development. 

The translating program (compiler/assembler/interpreter) gen¬ 
erally catches syntax errors and flags them as such in the pro¬ 
gram listing or on the terminal. On the other hand, you must 
locate clerical and logical errors by reexamining the program 
code and logic, using one or more debugging techniques. 

Some debugging techniques involve insertion of special debug¬ 
ging code within the program. For example, one way to locate 
logical errors is to write out intermediate results of a program. 
You can insert WRITE or PRINT statements at strategic points 
in the program logic to show the intermediate state of values 
being calculated. When debugging is complete, you can remove 
these statements or change them to comments. 

You may also find it useful to write a special debugging subrou¬ 
tine that writes out values, particularly if the same variables 
must be examined in several places or many times. 

Another method for finding logic errors — unit testing — is to 
break the program into smaller parts and test each part sepa¬ 
rately with artificial data. After you test all parts individually, 
you can test routine and module linkage — system testing — to 
see that all related code fits together properly. 

Check the program with test data. A standard method for 
checking out modules is to write a test program that calls the 
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program with possible options. The test should cause the pro¬ 
gram to execute all steps in all algorithms. Check programs 
first with representative data, then with improper data (data 
that is not in the correct range or size). You should also do 
volume testing to see that the program works successfully with 
a representative amount of data. 

Each programming language has special debugging aids for ex¬ 
amining immediate states. For example, BASIC-11 has a 
STOP statement that you can insert at strategic points in the 
program. When the program arrives at a STOP statement, it 
pauses so that you can use BASIC-11’s immediate mode to ex¬ 
amine variables, values, and so on. Use an immediate mode GO 
TO statement pointing to the appropriate line number to con¬ 
tinue execution. 

FORTRAN IV has a special DEBUG statement indicator, a D 
in the first column of a statement line. Operations in state¬ 
ments marked with a D can perform useful debugging func¬ 
tions, such as printing intermediate results. You can treat such 
statements as source text (and thus execute them) or as com¬ 
ments (and thus ignore them), depending on whether you use a 
special compiler command option. In addition, FORTRAN IV 
has a traceback feature that locates the actual program unit 
and line number of a run-time error. If the program unit is a 
subroutine or function subprogram, the error handler traces 
back to the calling program unit and displays the name of that 
program unit and the line number where the call occurred. This 
process continues until the calling sequence has been traced 
back to a specific line number in the main program unit. Fi¬ 
nally , FORTRAN IV has an optional interactive debugger 
called FDT (FORTRAN DEBU(JGING TECHNIQUE) that can 
be linked with a user program. 

For MACRO-11 users, RT-11 provides a special on-line debug¬ 
ging tool called ODT (On-line Debugging Technique). This is 
provided as part of the RT-11 operating system and is an object 
program on your system volume. It is used exclusively for de¬ 
bugging assembled MACRO-11 programs. 

The use of ODT is described next for MACRO-11 users and for 
those FORTRAN IV users who will be combining MACRO-11 
and FORTRAN IV program code. Other users can continue to 
Chapter 15, or go back and perform one of the other language 
demonstrations. Refer to the reading path outlined in the 
Preface. 


ODT is an interactive debugging tool that allows you to mon¬ 
itor program execution from the console terminal. ODT is pro¬ 
vided as the object module ODT.OBJ on your system volume. 
To use it, you link ODT.OBJ with the assembled MACRO-11 


USING THE ON-LINE 
DEBUGGING 
TECHNIQUE 
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program that needs debugging. You then start execution of the 
resulting load module, not at the transfer address of your pro¬ 
gram, but at the entry point of the ODT module (shown on the 
linker load map as the global symbol O.ODT). Once ODT is 
started, you can use its special debugging commands to control 
the execution of your assembled machine language program 
from the console terminal, to examine memory locations, to 
change their contents, and to stop and continue program execu¬ 
tion. 

The MACRO demonstration program in Chapter 11 still con¬ 
tains one error, which you can locate and correct using ODT. 
Several ODT debugging commands are demonstrated in the 
process. 

Throughout the examples in this chapter you need to refer to 
the program assembly listing of SUM.MAC. The listing that 
was produced in Chapter 11 was deleted, so you must create a 
new program assembly listing. Assemble your source program 
and produce a cross-referenced assembly listing as you did in 
Chapter 11. (Remember that SUM.MAC is now on your storage 
volume.) 


Long Command Format 

•MACROda) 

Files? OOL; SUM/LI ST/CROSSREFERENCE® 

Short Command Format 

•MACRO VOL: SUM/LI ST/CROSSREFERENCE® 

Print the listing on either the terminal or the line printer; 


Long Command Format 

(Line printer) (Terminal) 


•PRINT® 

Files? SUM.LST® 


TYPE® 

Files? gL)f.|,l_sT® 


Short Command Format 

(Line printer) (Terminal) 


•PRINT SUM.LST® TYPE SUM.LST® 

SliH.MAC VERSION 1 MACRO VOS.00 Ssturdaw 0a-Jan-a3 09138 1 


.TITLE SUM.MAC VERSION 1 
.MCALL .TTYOUT. .EXITr .PRINT 

N - 70. »N0. OF DIGITS OF 'E' TO CALCULATE 

» 'E' - THE SUM OF THE RECIPROCALS OF THE FACTORIALS 

» l/0( + 1/n + 1/21 + 1/31 + 1/41 + 1/5! + ... 

exp: .print ♦messag iprint introductory text 
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12 000006 
13 000012 
16 000016 
13 000022 

16 000024 

17 000026 
IB 000030 
1? 000032 

20 000034 

21 000036 

22 000040 

23 000044 

24 000046 
23 000032 
26 

27 000034 

28 000036 

29 000060 

30 000062 

31 

32 000064 

33 

34 000070 
33 000072 

36 000074 

37 000076 

38 

39 000102 

40 000104 

41 000110 

42 000114 

43 000116 

44 000120 
43 000122 

46 

47 000124 

48 

49 

30 

31 000342 
000343 
000330 

. 000333 

000336 
000361 
000364 


012703 000106 

012700 000107 

012701 000124' 

006311 

011146 

006311 

006311 

062621 

005300 

001371 

012700 000106 

014103 

012702 177777 

003202 

160003 

103375 

060003 

010311 

060261 177776 

003300 

001364 

014100 

162700 000012 

103375 

062700 000072 

005011 

005303 

001334 


000107 


124 no 

040 126 

114 125 

040 117 

040 105 

111 123 

013 012 


MOV 

first: MOV 

MOV 

second: asl 

MOV 

ASL 

ASL 

ADD 

DEC 

BNE 

MOV 

third: MOV 

MOV 

fourth: INC 


«NrR5 

♦N+1,R0 

«AtRl 

8R1 

eRl»-(SP) 

8R1 

I»R1 

(SP)+»<R1)+ 

RO 

SECOND 

•N>RO 

-(R1)»R3 

♦-1*R2 

R2 


»N0. OF CHARS OF 'E' TO PRINT 
♦NO. OF DIGITS OF ACCURACY 
♦ADDRESS OF DIGIT VECTOR 
♦DO MULTIPLY BY 10 (DECIMAL) 
♦SAVE *2 

♦ »4 

♦ «8 

♦NOW »10r POINT TO NEXT DIGIT 
♦AT END OF DIGITS? 

♦BRANCH IF NOT 

♦GO THRU ALL PLACES* DIVIDING 
♦BY THE PLACES INDEX 
♦INIT QUOTIENT REGISTER 
♦BUMP QUOTIENT 


SUB 

BCC 

ADD 

NOV 

ADD 

DEC 

BNE 

NOV 

fifth: sub 


R0rR3 

FOURTH 

R0»R3 

R3t8Rl 

R2*-2(R1) 

RO 

THIRD 
-(RDfRO 
•10.fRO 


BCC FIFTH 

ADD •lO.^'OrRO 

.TTYOUT 

CLR »R1 

Dt:C R5 

BUE FIRST 

.EXIT 


♦SUBTRACT LOOP ISN'T BAD 

♦NUMERATOR IS ALWAYS < 10*N 

♦FIX REMAINDER 

♦SAVE REMAINDER AS BASIS 

♦FOR NEXT DIGIT 

♦GREATEST INTEGER CARRIES 

♦TO GIVE DIGIT 

♦AT END OF DIGIT VECTOR? 

♦BRANCH IF NOT 

♦GET DIGIT TO OUTPUT 

♦FIX THE 2.7 TO .7 SO 

♦THAT IT IS ONLY 1 DIGIT 

♦(REALLY DIVIDE BY 10) 

♦HAKE DIGIT ASCII 
♦OUTPUT THE DIGIT 
♦CLEAR NEXT DIGIT LOCATION 
♦MORE DIGITS TO PRINT? 
♦BRANCH IF YES 
♦WE ARE DONE 


a: .REPT N+1 

.WORD 1 
.ENDR 


♦INIT VECTOR TO ALL ONES 


103 MESSAO: .ASCII 
101 

105 

106 
040 
072 
062 


/THE VALUE OF E ISI/ <15><12> /2./ <200> 


SUM.MAC VERSION 1 


MACRO VOS.00 Saturdaw 08-Jan-83 09:38 Pad# 1-1 


000367 056 200 

32 

53 

54 000000' 


.EVEN 

.END EXP 


SUM.MAC VERSION 1 ♦lACRO VOS.00 Saturday 08-Jan-83 09:38 Pasa 1-2 

SuAbol labia 


A 000124R 

EXP OOOOOOR 


FIFTH 000076R 
FIRST 000012R 


. AB8. 000000 000 (RWrIfOBL*ABS*OVR) 

000372 001 (RW>I>LCL>REL*CON) 

Error* datactad: 0 


FOURTH 0000S2R 
MESSAO 000342R 


N « 000106 
SECOND 000022R 


THIRD 000044R 


••• Assaablar otatistics 

Work fila raadst 0 
Work fila writa*: 0 

Siza of work fila: 0222 Word* ( 33 Paaa*) 
Siza of cora aool: 15872 Word* ( 62 Paa**) 
Oaaratin* awataa: RT-11 

Claraod tiaa: 00)00:04.31 
DK:SUM * DK:SUM/C-DK:SUM 


SUM.MAC VERSION 1 MACRO VOS.00 Saturday 08-Jan-83 09(38 Pasa S-1 

Cro** rafaranca tabla (CREF VOS. 


A 1-14 

EXP l-ll# 

FIFTH 1-37# 

FIRST 1-13# 

FOURTH 1-25# 

MESSAO 1-11 

N 1-7# 

SECOND 1-15# 

THIRD 1-23# 


1-47# 

1-54 

1-39 

1-44 

1-28 

1-51# 

1-12 1-13 1-22 

1-21 
1-35 


SUM.MAC VERSION 1 MACRO VOS.00 Saturday 08-Jan-83 09:38 Pa9a M-1 

Cro** rafaranca tabla (CREF VOS.00) 


.EXIT 1-3# 1-45 

.PRINT 1-3# 1-11 

.TTYOU 1-3# 1-41 

Now link the MACRQ-11 program object module (SUM.OBJ) 
stored on the storage volume (VOL:) with ODT.OBJ by using 
the /DEBUG option, and print a load map directly on the ter¬ 
minal or the line printer, choosing one of the following com¬ 
mands: 

Long Command Format 


(Line printer) 


(Terminal) 


. LINK/MAP/DEBUG® 
Files? VOLtSUM® 


. LINK/MAP:TT:/DEBUG® 
Files? VOLrSUM® 


LINK/DEBUG 
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Short Command Format 

(Line printer) (Terminal) 


* LINK/MAP/DEBUG 

UOLiSUM® 

LINK/MAP 

:TT:/DEBUG OOLrSUM® 


RT-11 LINK VOB. 

,00 Load Map Saturday 0S-Jan-B3 10:06 

Pase 1 

5UM 

SAtl 

Title: ODT 

I dent: 

005.00 


Section 

Addr 

Size Global 

Oa 1 ue 

Global Oalue Global 

Oal ue 

. ABS. 

000000 

001000 = 256. 

words 

(RN »I »GBL »ABS tOOR) 



001000 

000372 = 125. 

wo rds 

(RN »I»LCL »REL »C0N) 


$0DT$ 

001372 

006152 = 1569 

. words 

(RN »I »LCL »REL »C0N) 





O.ODT 

001624 



Transfer address = 001B24» HiSh limit = 007542 = 1969. words 


Look at the load map, and note that ODT starts at address 
1372. The two modules together, ODT and SUM, reside in 
memory up to location 7542, the high limit. Look at the symbol 
table listing for the MACRO-ll program. This shows that the 
program is 372(octal) bytes long and starts at location 1000. 

To load and start execution of the load module, use the monitor 
RUN command. The RUN command brings the entire load 
module, called SUM.SAV, into the absolute (physical) memory 
locations shown in the load map and begins execution automat¬ 
ically at the starting, or transfer, address of the first module in 
memory, which is ODT. Type: 

Long and Short Command Format 

•run sum® 

ODT U05.00 

* 


ODT prints an identifying message on the terminal and an as¬ 
terisk indicating that you are in ODT command mode and can 
enter an ODT command. You are now using ODT to control the 
execution of your program.^ ODT commands let you execute the 
entire program or just portions of it, examine individual loca¬ 
tions, examine the contents of the PDP-11 general registers, 
and change the contents of any locations in your program you 
wish. If you make a mistake while you are typing any com¬ 
mands, type the DELETE key; ODT responds with a question 
mark (?) and, an asterisk (*), allowing you to enter another 
command. 


^Be sure to read the chapter on ODT in the RT-11 System Utilities Manual 
before you use ODT with any of yovur own programs. You must observe certain 
precautions when you write your program and when you load it with ODT. 
For example, you should make sure that ODT is not loaded into memory 
locations used by your program. Follow the precautions described in the 
RT—11 System Utilities Manual. 
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Look at locations 6 through 16 in the assembly listing. With 
ODT, you can examine these locations in memory as follows (all 
ODT commands use octal numbers, as does the assembly 
listing): 

* 1006/012705 50 
001010 /OOOIOG© 

001012 /012700© 

00101/1 /000107© 

001016 /012701® 


By typing a location address and a slash, you open that location 
for examination and possible modification. A line feed closes 
that location and opens the next sequential location for exami¬ 
nation. A carriage return simply closes the currently open loca¬ 
tion. 

Note that since the MACRO-11 program was linked to begin at 
address 1000, you must add the constant 1000 to each address 
shown in the assembly listing to obtain the actual address used 
during loading. ODT can do this for you by using special in¬ 
ternal locations called relocation registers. Each register can be 
set to a relocation constant. Thus, if you have linked several 
modules together, you can set various relocation registers to the 
corresponding relocation constants of the individual modules. 
You then indicate in your command which register to use, and 
ODT automatically adds the constant in that register to the 
address specified in your command. For example, set relocation 
register 0 to 1000: 


* 


Now, to examine locations 0 through 10 in the assembly listing, 
type: 


* 0 >0/012700© 

0»000002 /0013/I2® 

0 tOOOOO/l / 104351 © 

0(000006 /012705© 

0»000010 /OOOIOG® 

In your commands, indicate the number of the relocation reg¬ 
ister (followed by a comma), since generally you will have more 
than one register set at a time. 

Execute the MACRO-11 program now, using the ODT ;G com¬ 
mand, indicating in the command where you wish execution to 
start. In this case, the program’s start (transfer) address is 
1000, so type: 

^ 0 10 i G 

THE VALUE OF E IS: 

2.5/G06/S0G237.2301314.0S525/130aa02755350Z5.714777373527/14171)5405502.544 
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As you discovered in Chapter 11, these program results are 
incorrect. Note that a period has printed, indicating that you 
are back in monitor command mode. This particular 
MACRO-11 program returns to the monitor after execution. 
Therefore, to continue using ODT, you must RUN the load 
module again: 

Long and Short Command Format 


ODT 005.00 

* 


Changes that you make to a program while using ODT, and 
ODT register assignments that you make, are temporary. Thus, 
when you restart ODT, you must reenter any commands, such 
as relocation register commands, that you want to remain in 
effect. Reset relocation register 0: 

*1000iOR 

To help you find programming errors, ODT provides a break¬ 
point feature. Setting one or more breakpoints in a program 
causes program control to pause at those locations during exe¬ 
cution. When control pauses, ODT prints a short massage on 
the terminal, informing you that a breakpoint has occurred and 
showing the location at which execution has stopped. This 
pause returns control to ODT and gives you the opportunity to 
examine and possibly modify variables or data. Breakpoints are 
numbered from 0 to 7, so that you can have a total of eight 
breakpoints set at various instructions in the program at one 
time. 

For example, set breakpoint 0 at location 22 (line 16 in the 
assembly listing) and breakpoint 1 at location 40 (line 23): 

*0 »22;0B 

Now when you run the program, control pauses first at location 
22. Since the breakpoint was set at the instruction at location 
22, that instruction has not yet been executed, but all preceding 
instructions have: 

4P»o;g 

TBOiO(000022 

Note the message that ODT prints when execution reaches the 
breakpoint. Normally when execution encounters a breakpoint, 
only the breakpoint number and location are printed on the 
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terminal. In this case, the letter T precedes the breakpoint mes¬ 
sage. This happens because of the way the ODT program uses 
the console terminal. The assembly instruction .PRINT at line 
12 of the assembly listing requests the monitor to print a pro¬ 
gram message at the same time that ODT needs to print the 
breakpoint message. ODT, however, has higher priority. By the 
time the .PRINT request starts to print the program message, 
execution reaches the breakpoint and gives control to ODT. The 
.PRINT request has time to print only one character of its mes¬ 
sage before ODT takes over and prints the breakpoint message. 
When the program regains control, its message will continue 
printing from the second character. 

Program control has paused at location 22 in the MACRO-11 
program. Look in the assembly listing at the instructions that 
occur there. The instruction at location 16 (line 15) stores the 
address of the digit vector (at label A) in register 1 (Rl). Exam¬ 
ine the contents of register 1 to discover what this address is; 
then open the address and examine its contents and the con¬ 
tents of several addresses following it by using two new ODT 
commands, $ and @: 

**1/001124 @ 

0>000124 /OOOOOl© 

0.000126 /OOOOOl© 

0.000130 /OOOOO10 
0.000132 /OOOOOl® 

The $ command opens for examination the contents of one of 
the general PDP-11 registers 0 through 7. The @ command 
uses the contents of the currently open location as an address 
and opens that location for examination. Notice that the digit 
vector A, which begins at location 124, has been initialized to 
the value 1, the precise value indicated by the comments at line 
48 of the program listing. 

If you were to continue program execution now, the branch in¬ 
struction at line 22 of the assembly listing would cause pro¬ 
gram control to loop back to the instruction at line 16 where 
breakpoint 0 is set, again causing execution to pause. Since you 
wanted to continue to the next breakpoint (set at location 40), 
you must first cancel the breakpoint at location 22. To do this, 
type; 


«;oB 

This removes the breakpoint at location 22. The number (in 
this case 0) indicates which breakpoint is to be removed. Now 
continue program execution using the ;P command (proceed 
from breakpoint). Execution progresses through the loop and 
continues until it reaches the breakpoint set at location 40: 
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* iP 

HBl ;0 >000040 

(Note that the monitor has time to print the second character, 
and perhaps additional characters, of the program message be¬ 
fore ODT gains control.) Now examine the contents of several of 
the program vector locations beginning at location 124: 

* 0 >1244)00012 ® 

0 >000126 /000012 O 

0>000130 /000012:© 

0>000132 /000012:® 

The instructions prior to the breakpoint at location 40 consti¬ 
tute a multiplication routine. This routine multiplies the vector 
contents by 10 (12 octal), as you have just verified. 

You can see how the breakpoint feature is a very useful debug¬ 
ging aid. It allows you to execute selected portions of a program 
and verify that data and variables are being used correctly 
during execution. You can use the breakpoint feature to locate 
the error that is in this program. 

First, clear all previously set breakpoints (in this case, there is 
only the one at location 40) by typing the ;B command with no 
argument. 

* 5B 


Now set a breakpoint at location 110 (line 41 of the assembly 
listing). You want to verify the data that is being passed to the 
monitor in register 0 in the ADD instruction in line 40. 

»o>iio;oB 
# 5P 

EB0;0>000110 

Now examine the contents of register 0. 

**0^000065 \)G5 =5® 

At this point in execution, register 0 contains 000065. The 
backslash (\) command prints the low-order byte of the opened 
location on the console terminal and also converts this to an 
ASCII character (if it is a valid ASCII code) and prints the 
character. In this case, the number 5 prints. If you look back at 
the program results printed earlier in this chapter, you can see 
that 5 is the first digit of the tabulated result (following the 
message THE VALUE OF E IS 2). If you are experienced in 
mathematics, you know this result is incorrect because the ap¬ 
proximate value of E is 2.718. And you now also know that the 
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program error is not in the interface to the monitor service used 
to print the result (.TTYOUT), but that it occurs somewhere 
before location 110. So the next step in debugging this program 
is to set a breakpoint at some earlier point in the program logic 
and to rerun the program. You must restart ODT to do this. 
Return to monitor mode by typing CTRL/C. The remainder of 
the program message prints on the terminal; then the monitor 
period appears, indicating that you are in monitor mode. 

♦ ctrl/c) 

VALUE OF E IS; 

2 . 


Restart ODT and reset relocation register 0. 

.RUN SUM® 

ODT VOS.00 

*iooo;oR 

Set a breakpoint at location 76 (line 37 in the assembly listing), 
and start program execution at its beginning. 

»0 .7G;0B 

♦ 0.0 ;g 

TBO ;0 .00007G 

Again, examine register 0 to verify its contents. 

♦ $0/000033® 

By following the program logic in the assembly listing, you 
know that the value in register 0 should at this point be 
33(octal) (2.7, previously multiplied by 10, = 27[decimal] = 
33[octal]). So the value in register 0 is correct. From this, you 
can deduce that the error must occur somewhere between loca¬ 
tions 76 and 110. The proper step now is to check the assembly 
listing, where you find the error at line 40. The decimal point 
that should follow the 10, identifying it as a decimal 10, is 
missing. Therefore the program treats the 10 as an octal 10, or 
8(decimal), making each digit in the result off by an additive 
factor of 2. The data in location 106, then, should be 72, not 70. 
Since this data has not yet been used, you can change it now 
with ODT and continue program execution; if it had been used, 
you would need to restart ODT and then change the data. To 
change the contents of a location, simply open the location, tj^ie 
in the new contents, and close the location, using a carriage 
return. 

*0.106/000070 72® 
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Now eliminate all breakpoints. 

* ;b 

Continue program execution; the correct results should print. 

• ip 

THE VALUE OF E IS: 

2.7182Bia28a590a5235360287a71352SG2a977572fl709369S95957a9669S7G2772a07GB 


SUMMARY: 
COMMANDS FOR 
DEBUGGING 
PROGRAMS 


To Start ODT 
LINK/DEBUG 

Link the assembled program (the program to be debugged) 
with the ODT object module. 

To Use ODT^ 

m 

Close the currently open location and open the next sequen¬ 
tial location for examination and possible modification. 


Close the currently open location, 
addr/ 

Open the location indicated (addr) for examination and pos¬ 
sible modification. 

addr;G 

Begin program execution at the indicated address (addr). 

;P 

Continue program execution from a previous breakpoint. 
addr;nB 

Set one of the eight available breakpoints (n) at the indicated 
address (addr). 

;nB 

Cancel the indicated breakpoint (n). 

Cancel all breakpoints. 
addr;nR 

Set one of the eight available relocation registers (n) to the 
relocation constant value indicated by addr. 


'Only a very few of the available debugging commands have been demon¬ 
strated in this chapter. Consult the RT-11 System Utilities Manual for all 
ODT commands. 
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$n 

Open one of the eight general registers (n) for examination 
and possible modification. 


@ 

Use the contents of the currently open location as an address; 
close the currently open location; go to the new address, and 
open it for examination and possible modification. 


Print on the console terminal the low-order b)i» of the cur¬ 
rently open location; if possible, convert the value to an 
ASCII code and print the corresponding character on the ter¬ 
minal. 


Changes you make with ODT are temporary. Therefore you 
should now use the editor to correct the source program 
SUM.MAC. You should edit line 40 so that it reads: 

ADD •10.+'0*R0 SHAKE DIGIT ASCII 

The file SUM.MAC is currently stored on the storage volume 
VOL:. Edit this file, then reassemble, relink, and rerun it to 
verify that it is correct. When you have done this, store the 
updated version of the source file on the storage volume under 
the same name (SUM.MAC), including the files SUM.OBJ and 
SUM.SAV. 

After you have corrected and rerun the program, continue on to 
Chapter 15, or go back and perform one of the other language 
demonstrations. Refer to the reading path outlined in the 
Preface. 


RT—ll System Utilities Manual (AA—M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-11 system utilities. 


FILE MAINTENANCE 


REFERENCE 
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CHAPTER 15 

USING THE FOREGROUND/BACKGROUND MONITOR 


A special feature of the RT-11 operating system is that it pro¬ 
vides a choice of operating environments. You are using its 
foreground/background environment. This environment allows 
two independent programs to reside in memory at the same 
time and to execute concurrently. 

You have used the foreground/background (FB) monitor to con¬ 
trol the system and to perform the various exercises in this 
manual. 


The foreground/background environment is designed so that 
two programs can — but need not — share memory and run 
concurrently. One of these programs you designate as the fore¬ 
ground program. The system gives priority to the foreground 
program (or job, as it is usually called) and allows it to run until 
some condition, perhaps waiting for an I/O completion, causes it 
to relinquish control to the other program (the background job). 
The system then allows the background job to run until the 
foreground job again requires control, and so on. In this way, 
the two programs share system resources. Whenever the fore¬ 
ground program is idle, the background program runs. Yet 
whenever the foreground program requires service, its requests 
are immediately satisfied. To the user at the terminal, the two 
programs appear to run simultaneously. 

Foreground priority programs are generally time-critical. For 
example, you may want to designate as the foreground job a 
program that collects and analyzes data. Background programs 
are usually non-time-critical. Thus, you can continue to do pro¬ 
gram development as the background job by using monitor com¬ 
mands to run the editor, the FORTRAN IV compiler, the linker, 
and so forth. 

In order to perform the following exercises your system must 
have a clock. Verify whether your system has a clock by en¬ 
tering the TIME command twice. If the time displayed changes, 
your system has a clock. If your system does not have a clock 
you should skip ahead to Chapter 16. 


THE 

FOREGROUND/ 

BACKGROUND 

ENVIRONMENT 


Two programs are provided for you to run a foreground/back¬ 
ground demonstration. These programs reside on your system 
volume. The background job is called DEMOBG, and the fore¬ 
ground job DEMOFG. The function of the foreground job is to 
send messages every two seconds to the background job, telling 
it to ring the terminal bell. The background job recognizes 


RUNNING THE 
FOREGROUND/ 
BACKGROUND 
PROGRAMS 
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Creating the 
Background Job 


Editing the 
Background Job 


Running the 
Background Job 


these messages and rings the bell once for each message sent by 
the foreground job. 

Although the foreground job is always active, sending messages 
to the background job every two seconds, other programs be¬ 
sides DEMOBG can be executed in the background. Only when 
DEMOBG is active, however, is the circuit complete so that 
messages can be successfully received and honored. During the 
periods when DEMOBG is not running, the foreground pro¬ 
gram enters the messages in the monitor message queue. Once 
you restart DEMOBG in the background, the system immedi¬ 
ately dequeues all the messages since the last exit of DEMOBG, 
resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes, and the bell 
rings every two seconds as each current message is sent and 
honored. 


The background program DEMOBG.MAC is an assembly lan¬ 
guage source file and must be assembled and linked before you 
can use it. When you execute DEMOBG, it displays a message 
on the terminal. It is assumed that you have set the date. 


Use the text editor to modify the background job, 
DEMOBG.MAC. One of the lines of the message that is output 
by the program has a semicolon character preceding it, which 
makes the line a comment field. This will prevent the line from 
being printed as part of the message. Thus, the semicolon must 
be deleted from that line. 

Change the line 
; .ASCII /WELL DONE./ 

to 

.ASCII /WELL DONE./ 


If you performed the demonstration in Chapter 11, you are al¬ 
ready familiar with assembly/link operations, and the following 
command explanations can serve as a review. If you did not 
read Chapter 11, simply type the command lines as shown. 

Assemble the background job. 

Long Command Format 

. MACRO® 

Files? DEMOBG/LIST® 
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Short Command Format 

. MACRO DEMOBG/LIST® 

Link the .OBJ file produced by the assembler to create a run¬ 
nable job. 

Long Command Format 

. LINK® 

Files? DEMOBG® 

Short Command Format 

. LINK DEMOBG® 

Now run the background job and check the results. 

. RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will 
not be output. Return to the monitor by typing two successive 
CTRL/Cs. 

ICTBL/C 1 

m/c 1 


*c 

*c 


The FB monitor provides you with commands that allow you to USING THE 

control the two-job environment. They let you interact with the FB MONITOR 

two jobs and let the two jobs interact with one another. 


When two jobs run simultaneously, you must have some means 
of indicating the job to which you are directing commands. 
Likewise, the two jobs must have the means to identify them¬ 
selves when they have messages to print. The following are 
some conventions that apply to system communication in a two- 
job environment. 

1. The foreground job has priority. If both the foreground and 
the background job are ready to print output at the same 
time, the foreground job prints first. The foreground job 
prints a complete line, then the background job prints a 
complete line, and so on. 


Communication 
in a Two-Job 
Environment 
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Creating the 
Foreground Job 


LINK/ 

FOREGROUND 


2. Either job can interrupt your input at the terminal if it has 
a message to print. 

3. Messages printed by the background job are preceded by the 
characters B>. 

4. Messages printed by the foreground job are preceded by the 
characters F>. 

5. T3T)ed commands are initially directed to the background 
job. You can redirect control alternately to the foreground 
and background jobs by using the CTRL/F and CTRL/B 
commands. 

To direct typed input to the foreground job, type CTRL/F. 
This command instructs the monitor that all subsequent 
terminal input — commands and text — is directed to the 
foreground job. Typing this command causes the system to 
print an F> on the terminal, unless output is already 
coming from the foreground job. Command input remains 
directed to the foreground job until the foreground job ter¬ 
minates, or until it is redirected to the background job 
through CTRL/B. 

To direct typed input to the background job, type CTRL/B. 
This command instructs the monitor that all subsequent 
terminal input — commands and text — is directed to the 
background job. Typing this command causes the system to 
print a B> on the terminal, unless output is already coming 
from the background job. Command input remains directed 
to the background job until redirected to the foreground job 
through CTRL/F. 


The foreground program DEMOFG is an assembly language 
source file; it must be assembled and linked before you can use 
it. 

Long Command Format 

. MACRO® 

Files? DEMOFG/LIST® 

Short Command Format 

. MACRO DEMOFG/LIST® 

The output resulting from this MACRO command includes an 
object file called DEMOFG.OBJ and a listing file called 
DEMOFG.LST. The command creates both files on your system 
volume. You must link the .OBJ file to produce a runnable 
foreground program. You use the LINK command, just as you 
have in earlier chapters, but you also use the /FOREGROUND 
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option.^ This option produces a load module with a .REL file 
type which signifies to the system that the file is a foreground 
program and is to be run as the priority job. 

Long Command Format 

.LINK/FOREGROUND® 

Files? DEMOFG® 

Short Command Format 

.LINK/FOREGROUND DEMOFG® 

Now you are ready to operate the two-job environment. Many 
times, you have to consider the devices that are used for output 
in a foreground/background environment. For example, if your 
program assumes that the output device is a line printer, and 
you do not have a line printer or you want to output to another 
device, use the ASSIGN command. Type this command in the 
following way, substituting the two-letter mnemonic from 
Table 4-2 for the storage volume in place of dd. 

Long Command Format 

. ASSIGN® 

Physical device name? dd:® 

Logical device name? LP:® 

Short Command Format 

.ASSIGN dd: LP:® 

You do not have to consider the above information for the dem¬ 
onstration programs that are provided, since the foreground job 
communicates with the background job, and both jobs send 
their output to the terminal. 

When you use the FB monitor, you must always load into 
memory the peripheral device handlers needed by the fore¬ 
ground job. You use the monitor LOAD command to make a 
device handler permanently resident in memory. For example, 
if your foreground job requires the use of the line printer, you 
must load the LP device handler. You must specify the jobtype 
with the command. For a foreground job, the jobtype is F; for a 
background job, the jobtype is B. If you have assigned the code 
LP: to another device, the system automatically loads the as¬ 
signed handler and you need not enter a LOAD command. If 
you are using the line printer, type: 


Executing the 
Foreground and 
Background Jobs 


LOAD 


'This command option also applies to compiled FORTRAN IV programs that 
are to be linked as a foreground job. 
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Long Command Format 

• LOAD® 

Device? LP;=F® 


FRUN 


Short Command Format 

• LOAD LP;=F® 

The command to load and start execution of the foreground job 
is FRUN, which is similar to the RUN command except that 
the system automatically loads and starts the execution of the 
foreground .REL program. (To execute a FORTRAN IV fore¬ 
ground job, you must use the /BUFFERm option with the 
FRUN command. The argument n represents, in octal, the 
number of words of memory to allocate.) Use this command to 
start the execution of DEMOFG.REL. 

Long and Short Command Format 

• FRUN DEMDFG® 

F> 

FOREGROUND DEMDNSTRATIDN PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM "OEMOBG" 
EUERY 2 SECONDS» TELLING IT TO RING THE BELL. 

B> 

The foreground program DEMOFG is now running and 
queuing the message for the background program every two 
seconds. You now execute the background program DEMOBG 
to allow it to receive the messages that were queued and to ring 
the bell. 

• RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE. 

WELL DONE. 

The bell rings several times in rapid succession as the monitor 
dequeues the messages, and then every two seconds as the fore¬ 
ground job sends its message to the background job. 

You can run other jobs in the background. First, terminate the 
background job DEMOBG, using the double CTRL/C command. 

CTRL/C ) 

fcm/c) 


Execute a DIRECTORY command in the background to get a 
listing of all the .OBJ files on the system volume by typing: 

» DIRECTORY «.OBJ® 
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The foreground job is still running and queuing its messages to 
the monitor. Rerun the background program to collect all the 
foreground messages while the background job was stopped and 
the directory was printing. 

•RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE. 

WELL DONE. 


The bell again rings several times in succession and then rings 
once every two seconds. Stop the background job by using the 
double CTRL/C command. 

(CTRL/C) 

tTRL/C) 


Now stop the foreground job and remove it from memory. To do 
this, you must first use the CTRL/F command to direct teiminal 
input to the foreground. Type: 


• m/F 1 
F> 

The system prints the characters F> to remind you that you 
are now directing command input to the foreground job. Use the 
double CTRL/C command to interrupt and terminate the execu¬ 
tion of the foreground job, and return control to the background 
job. 

mile) 

(CTRL/Cl 

B> 

You should unload the foreground job to reclaim memory space 
for background use. Use the monitor UNLOAD command as 
follows: 


UNLOAD 


Long and Short Command Format 

UNLOAD F® 


F represents the foreground job; you should use this code when¬ 
ever you want to unload the foreground job. To unload any 
loaded device handlers, you must use their two-letter device 
mnemonics. 

Check to see if the .LST files were produced as a result of this 
demonstration. 
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Long and Short Command Format 



DIRECTORY ».LST 

* 

08-Jan-B3 „ m 

DEMOBG»LST 08-Jan-83 DEMOFG.LST 8 08-Jan-83 

2 Filesf 10 Blocks 
aOS Free blocks 

The foreground program has access to all the system features 
available to a background program — opening and closing 
files, reading and writing data, and so on. However, before you 
begin to write and use programs in the foreground, read the 
RT-11 Software Support Manual for coding restrictions. 

SUMMARY: 
COMMANDS USED 

IN AN FB 
ENVIRONMENT 

CTRL/B 

Direct all keyboard input to the background job (until 
CTRL/F). 

CTRL/F 

Direct all keyboard input to the foreground job (until 
CTRL/B). 

FRUN 

Load and start execution of the foreground job. 

LOAD dd 

Bring the indicated device handler into memory; the handler 
becomes resident in memory. 

UNLOAD dd 

Take the indicated device handler out of memory, reclaiming 
its memory space; the handler becomes nonresident in 
memory. 

UNLOAD FG 

Reclaim the memory space used by the foreground job. 

FILE MAINTENANCE 

You assembled the source file DEMOFG.MAC and produced an 
.OBJ file, linking it to produce DEMOFG.REL. You also cre¬ 
ated a .LST file named DEMOFG.LST on your system volume. 
You should save on your storage volume the files 
DEMOFG.REL and DEMOFG.MAC, and delete from your 
system volume the files DEMOFG.OBJ and DEMOFG.LST. Do 
not delete DEMOFG.MAC, since this file was distributed as 
part of the RT-11 operating system. Do the same for the file 
DEMOBG, which you created as a .SAV file instead of a .REL 
file. 
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Long Command Format 


, COPY® 

From? DEMOFG.MAC fOEMOFG.REL® 
To ? MOL;*.*® 


Files copied: 

DK:DEMOFG.MAC to VOL:DEMOFG.MAC 
DK:DEMOFG.REL to VOL:DEMOFG.REL 


. DELETE® 

Files? DEMOFG.OBJ .DEMOFG.LST® 



Short Command Format 

.COPY DEMOFG.MAC »DEMOFG.REL VOL:*.#® 

Files copied: 

DK:DEMOFG.MAC to VOL:DEMOFG.MAC 
DK:DEMOFG.REL to VOL:DEMOFG.REL 

.DELETE DEMOFG.OBJ .DEMOFG.LST® 

Finally, obtain a brief directory listing of your storage volume 
so that you can see its current status: 


Long and Short Command Format 

.DIRECTORY/BRIEF VOL:® 


RT-11 Software Support Manual (AA-H379B-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A technical manual providing RT-11 programming concepts. 

RT~11 System User’s Guide (AA-6279C-TC). Maynard, Mass.: Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT—11 operating system. 

o 



REFERENCES 
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CHAPTER 16 
USING INDIRECT FILES 


The RT-11 system provides an operational aid called an indi¬ 
rect file, which allows the system to run unattended. An indi¬ 
rect file is a file composed entirely of monitor operating com¬ 
mands. When you start the execution of the indirect file, the 
monitor processes these commands in consecutive order. So 
once you have created an indirect file and started its execution, 
you can direct your attention to other tasks or even physically 
leave the system, since the monitor executes the commands au¬ 
tomatically and consecutively.' 

The kinds of operations that RT-11 can best perform in an 
indirect file are those that involve much computer processing 
but that do not require your supervision or intervention. For 
example, multiple assemblies, compilations, and data transfer 
operations are ideal operations for indirect file processing. Also, 
any series of commands that you are likely to type often can 
easily run as an indirect file. 


Use the editor to create an indirect file as a text file. You can 
call the file by any file name you wish, but you should give it a 
file type of .COM, since this file type is the default used by the 
monitor to locate the file. 

You structure the lines of text that make up an indirect file just 
like keyboard input. Thus, if you were to list the indirect file it 
would look like terminal keyboard text without any monitor 
prompts. 


You enter monitor commands into the indirect file as you would 
on the terminal. As an example, both of the following accom¬ 
plish the same operation when executed as part of an indirect 
file: 


COPY® 

INFIL.MAC® 

OUTFIL.MAC® 

COPY INFIL.MAC OUTFIL.MAC® 

Since monitor prompts are not included in the indirect file, 
using the long command format requires that you anticipate 

'The indirect file concept is similar to BATCH processing. Although indirect 
files lack many of the BATCH capabilities, they are easier to u'se than 
BATCH. (The RT-11 computer system also supports a BATCH processor, as 
described in the RT-11 System Utilities Manual.) 


CREATING AN 
INDIRECT FILE 


Entering Monitor 
Commands 
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each prompt and its proper response. It is suggested that you 
use the short command format and enter the command as a 
single line of text. Terminate each command line with a car¬ 
riage return. 


Using the Editor 
to Create an 
indirect Fiie 


The indirect file that you will now create incorporates several 
of the commands previously demonstrated in this manual. Thus 
it serves both as an example of the format of indirect file input 
and as a brief review of the monitor commands used to copy, 
process, and delete files. In addition, one new command, DEAS¬ 
SIGN, is demonstrated. 

List a directory of your storage volume. The only files that 
should appear in the listing are GRAPH.FOR, SUM.MAC, and 
MATCH.BAS. All three files will be in the directory only if you 
performed the exercises for all three languages (FORTRAN IV, 
MACRO-11, and BASIC-11). 


Long and Short Command Format 

.DIRECTORY OOL;® 

08-JAN-83 

SUM .MAC 3 08-JAN-83 MATCH .BAS 3 08-JAN-83 

GRAPH .FOR 2 08-JAN-83 

3 Files* 8 BlocKs 
4754 Free blocKs 


If any other files are listed, delete them using the DELETE 
command before you create the indirect file. 

Use the EDIT/CREATE monitor command to create a file called 
INDCT.COM, inserting the commands according to the direc¬ 
tions in the right-hand column. When you have finished cre¬ 
ating the file, list it and check for typing errors. Correct any 
errors you find, and then close the file, using the EX editing 
command. 


Long and Short Command Format 


.EDIT/CREATE INDCT.COM® 
♦ IDATE B-JAN-83® 

TIME 8:00:00® 

DATE® 

DE. ASSIGN® 

ASSIGN TT: LP:® 


Enter a hypothetical date 
and time (if your system has 
a clock). 

Print the date. 

Deassign all previous device 
assignments and set new 
ones as follows: 

Assign the logical name LP: 
to the terminal. 


ASSIGN ddn OOL:® 
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Assign the logical name 
VOL: to the storage volume 
(dd). 
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DIRECTORY/BRIEF VOL:® 


COPY VOL:GRAPH.FOR GRAPH.FOR® 


COPY VOL:SUM.MAC SUM.MAC® 


COPY VOLiMATCH.BAS MATCH.BAS® 


FORTRAN/LIST GRAPH® 

LINK/MAP GRAPH .SYSLIB .FORLIB® 


MACRO/LIST/CROSSREFERENCE SUM® 
LINK/MAP SUM® 


List an abbreviated direc¬ 
tory of VOL:. 

FORTRAN IV users insert 
this command to copy the 
FORTRAN IV demo pro¬ 
gram to the system volume. 

MACRO-11 users insert 
this command to copy the 
MACRO—11 demo program 
to the system volume. 

BASIC-11 users insert this 
command to copy the BA¬ 
SIC-11 demo program to 
the system volume. 

FORTRAN IV users who do 
not need to load the lan¬ 
guage volume include these 
commands to compile and 
link the FORTRAN IV 
demo program. 

All users assemble and link 
the demo program. 


RENAME MATCH.BAS MATCH.MAP® BASIC-11 users simply re¬ 
name the demo program. 


MACRO/LIST/CROSSREFERENCE 
LINK/FOREGROUND/MAP 
DEMOFG® 


DEMOFG® 

All users assemble and link 
the DEMOFG file. 


DIRECTORY *.OBJ® 


List a directory of object 
files. 


DELETE/NOOUERY GRAPH.#® 

DELETE/NOOUERY SUM.»® 

DELETE MATCH.MAP® 

DEASSIGN® 

TIME® 

* B/L®® 

DATE 8-JAN-83 
TIME 8:00:00 


FORTRAN IV users delete 
the GRAPH files. 

MACRO-11 users delete 
the SUM files. 

BASIC-11 users delete the 
MATCH file. 

Deassign all device assign¬ 
ments. 

If your system has a clock, 
print the time to show how 
long total processing took. 

Terminate the insert com¬ 
mand and list the indirect 
file to check for errors. (Ex¬ 
ample input is shown here.) 
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EXECUTING AN 
INDIRECT FILE 


DATE 

DEASSIGN 
ASSIGN TT: LPs 
ASSIGN RKl: UOL: 

DIRECTORY/BRIEF VOL: 

COPY VOLiGRAPH.FOR GRAPH.FOR 
COPY VOL:SUM.MAC SUM.MAC 
COPY VOL:MATCH.BAS MATCH.BAS 
FORTRAN/LIST GRAPH 
LINK/MAP GRAPH .SYSLIB(FORLIB 
MACRO/LIST/CROSSREFERENCE SUM 
LINK/MAP SUM 

RENAME MATCH.BAS MATCH.MAP 
MACRO/LIST/CROSSREFERENCE DEMOFG 
LINK/FOREGROUND/MAP DEMOFG 
DIRECTORY *.OBJ 
DELETE/NOOUERY GRAPH.# 
DELETE/NOOUERY SUM.# 

DELETE MATCH.MAP 

DEASSIGN 

TIME 

ttEXdlllll 


Close the file INDCT.COM. 


Once you have created an indirect file and checked it for errors, 
you are ready to start its execution. The command to start exe¬ 
cution of an indirect file is the at sign (@) followed by the 
appropriate file name (the file type .COM is assumed unless 
you indicate otherwise). Execution starts immediately, and the 
system processes commands in the indirect file in consecutive 
order. Each command is echoed on the terminal as it is pro¬ 
cessed. If an error within the indirect file affects the processing 
of a command, the system prints a system message on the ter¬ 
minal and stops execution of the entire file. Therefore, it is 
particularly important that you check your indirect file for er¬ 
rors before you start it and then leave the area. You can stop 
execution of an indirect file at any time by typing two 
CTRL/Cs. 

Run the indirect file that you have just created by typing: 
.@INDCT® 

It takes a minute or two for the commands in this file to be 
processed and for the listings to print. If your system has a 
clock, the time printed at the end of execution tells you exactly 
how long command processing has taken. Following is an ex¬ 
ample run. 

.»1NDCT 

.DATE B-JAN-83 

.TIME 8:00:00 

. DATE 
8-Jan-83 

.DEASSIGN 

.ASSIGN tt: lp: 

.ASSIGN KKt: vol: 

.directory/dkiif vol: 

08-Jar.-83 

GRAPH .FOR SUM .MAC MATCH .BAS 
3 Filas. 8 Block’s 
47S4 F ra« block f. 

.COPY vol:GRAPH.FOR GRAPH.FOR 

.COPY vol:SUM.MAC SUM.MAC 
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.COPY VOLtNATCM.MS HATCH.MS 

.rORTRAM/LIST QRHPH 
FORTRAM IV V02.S 


Sat 09-Jan-03 09:00:tA 


PAOC OOt 


C ORAPM.rOR VtRSlOM L 

C THIS PROORAM PRODUCES A PLOT OH THE TERHINAL 
C OF AH EXTERNAL FUNCTIOHt FUH(X>V> 

C THE LIHITS OF THE PLOT ARE DETE^RHINED DY THE DATA STATEHEHTS 
C *STAD* IS FILLED WITH A TADLE OF HEIOHT FLASS 
C ‘STRING* IS USED TO DUILD A LINE OF GRAPH FOR PRINTING 
0001 SCAL(ZHIN.ZHAX>HAXZ.K»2HINaFLOAT(K-l>«(2HAX-ZHIN>/FLOATIHAXZ-ll 

0007 L06ICALD1 STRIN0<133)rSTAD(10O> 

0003 MTA XNINtXHAX>HAXX/-S.O>S.O»4S/ 

0004 MTA YNINfYHAXtNAXY/-S.0>S.0t73/ 

OOOS MTA FHINtFHAX/O.0*1.0/ 

OOOA CALL SCOPYC- 123ASA780 4‘>STAD> 

0007 HAXF>LEN4STA»> 

0008 DO 20 IX-l.i1AXX 

XxSCAL(XHIN.XHAX.HAXX*IX) 

CALL REPEATSTRINGfHAXY) 

IFdX.EO.l .OR. IX.EO.HAXX) OOTO 20 
DO 10 IY>2>HAXY-t 

Y«SCAL<YNlN>VHAX•HAXYtIY) 

IFUN*2'»lNT(FLaAT(HAXF-3)«tFUN<X*Y>-FNIN>/(FHAX-FNlN>) 
STRING!IY>«STAD(NINO(NAXF*HAXO(1•IFUN)> > 

CALL PUTSTR(7*STRING*' ') 

CALL EXIT 
END 


0009 
OOlO 
0011 
0013 
0014 
OOlS 
001 *. 

0017 
0018 
0019 

TFORTRAN-I-C.NAIN.] Errors! O* Harninas: 2 
FORTRAN IV StoraSo Nar for Proara* Unit .NAIN. 

Local Variablasf .P8ECT tMTA. Siza - 000470 ( IS*, words) 


FNAX 




Twaa Offset 
R84 000402 

IX 1*2 000434 

NAXF 1*2 000432 

HAXZ 1*2 00042* 

XNIN R*4 000352 

YNIN R*4 0003*4 

Local and CONNON ArrawsS 

Naas Twra Section Offset --Siza--—- Dieansions 

STA8 L*1 AMTA 000205 000144 ( SO.) (100) 

STRING L*1 tOATA 000000 000205 ( *7.) (133) 


Twee Offset 
R*4 00037* 

000442 
0003*2 
00043* 
000444 
000422 


R*4 

R*4 

R*4 


NAXY 

XNAX 

YNAX 

ZNIN 


1*2 

1*2 

1*2 

R*4 

R*4 

R*4 


Offset 

000450 

000430 

000374 

00035* 

000370 

00041* 


Subroutines* Functions* 

Naee Twee Naee Tw 

EXIT R*4 FLOAT R 

HAXO 1*2 NINO I 

SCOPY R*4 


Stateeent an* Proeessor-Def irted FurtetiensS 

Naee Twei 
LCN I*: 


Naee Twee 

FUN R*4 
PUT8TR R*4 


Naee Twee 

INT 1*2 

REPEAT R*4 


Sat 0S-Jan-S3 OS10114* 


0001 

0002 

0003 


FUNCTION FUN<X*Y) 
RwSGRT(X**29Y**2) 

FUH>< X*Y*R*EXP <-R)> **2 
RETURN 


FORTRAN IV Storaae Nae for Proarae Unit FUN 

Local Variables* .PSECT tMTA* Size > 000024 < 10. words) 

Naee Twee Offset Naee Twee Offset Naee Twee Offset 

FUN R*4 000004 Eew R R*4 000010 X R*4 8 000000 

Y R*4 8 000002 

Subroutines* Furictiens* Stateeent and Processor-Defined Functiorts! 



Naee Twee Naee Twee Naee Twee Naee Twee Naee Twee 

EXP R*4 SORT R*4 

.LINK/NAP 0RAPH*SY8LI8*F0RLI8 

RT-11 LINK VOS.00 Load Nae Saturdaw 08-Jan-e3 08:02 Paae 1 

BRAPH .8AV Title! .NAIN. Ident! F0RV02 

Section Addr Size Global Value Global Value Global Value 



. ADS. 

0TS*I 


000000 001000 - 25*. 

•USRSU 

.VIR 

4HASIZ 

001000 017722 - 4073. 

•*OTSI 

•eVTID 

»1C 

«IR 

A0F4PS 

ADF*NS 

•SUDF 

ADF*SS 

DIF*PS 

•DIVF 

NUF*PS 

*NULF 

•OTl 

«*SET 

STK»I 


NHI41H 

DEO* 

MA* 

CAI* 

ERR* 

*OPNCR 

*EOL 

NOF*SS 

NOF*SN 

NOF*NA 

NOF*PA 

NOF*RN 

N6D*S 

NOF*N 

NOD*A 


RT-ll LINK VOS.00 


ADI*M 

ADI*IA 

ADI*NA 

CNI*8I 

CNISIl 

CNI*N1 

•IFH 

N0I4R9 

NOI*RP 

N0L4S8 

N01*IS 

NOI8IH 

N01*NH 

NOI*ON 

HOiaiN 

ICIDH 

DC1*8 

DCIM 

NOItIP 


Title! .NAIN. 


words <RW*I.GDL>ADS*OVR> 

000000 *RF2A1 000000 SHRDUR OOOOOO 

000000 *NLCHN OOOOO* *SYSV* 000012 

000152 *LRCCL 000210 *TRACE 004737 

words <RU*I*LCL*RCL*CON) 

001000 *CVTIF 001000 *CVTIC 001014 

001014 CCI* 00102* CDI* 00102* 

00102* *10 00102* CFI* 001042 

001042 EXP 00112* ADF*IS 0014** 

001474 SUF*PS 001500 SUF*NS 001504 

00151* SUF*IS 00152* *ADDF 001534 

001550 SUF*SS 0015*2 *SDR 0015*2 

0015** MDR 0015** ADD* 001*02 

00222* 0IF*NS 002232 DIF*1S 002242 

002250 DIF*SS 0022*2 *DVR 0022*2 

002550 NUF*NS 002554 NUF*IS 0025*4 

002572 NUF*SS 002*04 *NLR 002*04 

003142 **0T1 003144 *SETOP 003354 

00502* SORT 005322 STK*L 00551* 

005522 STK*F 00552* IOR* 00553* 

005542 EQV* 005550 XOR* 005552 

0055** NNI*1I 005*00 DLE* 005*10 

005*12 DOT* 005*20 DOE* 005*22 

005*24 DNE* 005*30 DLTD 005*32 

005*42 CAL* 005*50 END* 005700 

005712 *END 005724 *ERR 005742 

0057*4 *CHKER 00*022 4I0EX1 00*04* 

00*11* EOL* 00*11* EXIT 00*232 

00*23* NOF*NS 00*250 NOF*PS 00*2*2 

00*2** NOF*SP 00*27* NOF*HN 00*302 

00*314 HOF*NP 00*322 HOF*PN 00*330 

00*334 HOF«PP 00*340 NOF4RS 00*344 

00*352 NOFMA 00*3*2 NOFtRP 00*3** 

00*372 NGF4S 00*372 NGD4N 00*404 

00*404 N0D9P 00*420 NGF4P 00*420 

00*424 NGF4A 00*424 AD14SS 004430 

00*434 ADI4SN 00*440 A0I9IS 00*444 

00*450 ADItlN 00*454 ADI4NS 00*4*0 

00*4*4 A0I9NN 00*470 CHItSS 00*474 

00*500 CNI4SN 00*504 CNltlS 00*510 

00*514 CHI4IN 00*520 CNIMS 00*524 

00*530 CNI4HH 00*534 1FU4 00*540 

00*544 •*IFH 00*550 1FU99 00**0* 

00**5* HOL4RS 00**5* H014RN 00***2 

OO**** HOI4RA 00**70 N014SS 00**74 

00**74 N0I9SN 00*700 NOISSA 00*704 

00*710 N0L9IS 00*710 REL* 00*710 

00*714 NOIDIA 00*720 N0I4NS 00*724 

00*730 N019NA 00*734 NOItOS 00*740 

00*744 N0190A 00*750 NOISIS 00*754 

00*7*2 H0I41A 00*770 ICIDS 00*77* 

007002 ICIDP 00700* ICIDA 007010 

007014 OCItN 007020 DCItP 007024 

00702* IDINT 007032 INT 007032 

0070*0 NOIDSP 0070*2 HOIDPP 007070 

‘ Saturdaw OS-Jan-83 08:02 Paae 2 

Ident! F0RV03 


007144 
007170 
SUZ8SN 007334 


€> 


007370 
007410 
00742* 
007450 
N0L8IA 007470 


8U1DM 

8UI8ZA 

SUI8N* 


HOLM* 

N0L8NP 

N0L8PA 

N0L81P 


007112 

007134 

0071*4 

007330 

007344 

0073*0 

007374 

007414 

007432 

007454 

00747* 




16 ^ 






Using Indirect Files 


LLE* 

LOEt 

T8L«S 

T8L«P 

RETM. 

RET* 

TWL* 

•TWF 

TVQ* 

•TWP 


CIC« 

CLD* 

CLF* 

CLI* 


00790* 

007920 

00793* 

007994 

007*32 

007*4* 

010024 

010032 

01004* 

010094 


010320 

010320 

010330 

01044* 


LEQ* 

LNE* 

T9L«N 

NAXO 

«ET»F 

•0TI8 

•TVL 

TVD* 

•TVQ 

TVl* 

8AL*8R 

SAL*m 

SALtSP 

SALtNP 

•CVTFI 

4CVTDB 

CID* 


•INITI 

«ERRS 

*«FIO 

♦OETBL 

SA0RG4 

STP* 

•EXIT 

•DUHPL 


OTStO 0225*0 00103* > 271. 

SYStO 023*1* 000000 

•DATAP 023*1* 00010* 

OTS*D 023724 00000* 


02077* 

••OTSC 021242 


OTS*S 

SYS*S 


023732 000002 
023734 000004 


• DATA 
USER*D 

.«••«. 

RT-11 LINK 
GRAPH .SAV 


023740 00053* ■ 
02447* 000000 < 
02447* 000000 ’ 
V08.00 

Titl»: 


■ 35. words 

• 3. words 

NHCLN* 023730 

•ACTS 023732 

> 2. words 

•SYSLB 023734 

■ 175. words 

> 0. words 

• 0. words 


007510 LOT* 
007530 CCT* 
007942 
0075*2 
007*3* 

007702 
010024 
010040 
01004* 

0100*2 
010220 
010234 
01024* 

0102*2 
010272 
01030* 

010320 
010320 
010330 
010450 
011451 
01 * 0*0 
017742 
0201*2 
020350 
020374 
020574 
(RU.D.OBLrRELfOOR) 
(RUtIfLCLfRELtCON) 

REPEAT 021014 SCOPY o: 

<RUfIfLCL.RELfCON) 
<RWFliLCLfRELrCON> 

FUN 022120 PUTSTR O: 

(RUfIfLCLfRELtCON) 

♦OPEN 0225*0 

(RUfIfLCLfREL.CON) 
(RUrDfLCLrRELfCON) 
(RUtDrl-CL.REL.CON) 

<RU.DfLCL»REL.CON) 

(RUfDpLCLfREL.CON) 

•LOCK '02373* •CRASH O: 

(RUpDpLCL.REL.CON) 
(RUfDpLCLtRELpCON) 
(RUpDpGBLpRELpOUR) 

Ssturdsw 08-Jan-83 08:02 
F0RU02 


TSL*I 

NINO 

RET«1 

••OTIS 

TWF^ 

•TUB 

TWP4 

•TVI 

SVL^IH 

SUL^HN 

SWL^IP 

SVL^NP 

•CUTCB 

•CUTDI 

CLC^ 

CIF^ 

CIL^ 

•CLOSE 

•FCHNL 

•PUTRE 

•EOFIL 

THRD^ 

♦STP 

•HA IT 


00791* 

007532 

00754* 

007*0* 

007*44 

007704 

010032 

010040 

010054 

0100*2 

010224 

010240 

010252 

0102 ** 

01030* 

01030* 

010320 

010330 

010442 

0105** 

015212 

017224 

02012 * 

020340 

020350 

020520 


Transfer address - 021242 p Hieh lieit • 024474 » 5278. words 
.NACRO/LIST/CROSSREFERENCE SUM 


SUM.MAC UERSION 1 


10 

11 000000 
12 00000 * 

13 000012 

14 00001* 

15 000022 
1* 000024 

17 00002* 

18 000030 

19 000032 

20 000034 

21 00003* 

22 000040 

23 000044 

24 00004* 

25 000052 


MACRO U05.00 Saturdaw 08-Jan-03 08107 Pase 1 

.TITLE SUM.MAC VERSION 1 
.MCALL .TTYOUTp .EXIT. .PRINT 


N - 70. >N0. OF DIGITS OF E' TO CALCULATE 
'E' - THE SUM OF THE RECIPROCALS OF THE FACTORIALS 
1/0! + 1/1! + 1/2! ♦ 1/3! + 1/4! + 1/5! + ... 


exp: 


01114* 

00*311 

00*311 

0*2*21 

005300 

001371 

012700 00010* 


1*0003 

103375 

0*0003 

010311 


2* 

27 000054 

28 00005* 

29 0000*0 

30 0000*2 


32 0000*4 0*02*1 17777* 


34 000070 

35 000072 
3* 000074 

37 00007* 

38 

39 000102 

40 000104 

41 000110 

42 000114 

43 00011* 

44 000120 

45 000122 


47 000124 000107 


005300 

0013*4 

014100 

1*2700 000012 


005011 
005305 
001334 


MOV 
first: MOV 

MOV 

second: asl 

MOV 

ASL 

ASL 

ADD 

DEC 

BNE 

MOV 

third: MOV 

MOV 

fourth: INC 

SUB 

BCC 

ADD 

MOV 


DEC 

BNE 

NOV 

fifth: sub 


.PRINT OMESSAO 


•N.RS 
•Nfl.RO 
•A.Rl 
8R1 

8R1.-(8P> 

BRl 

»R1 

<8P>4.(R1>^ 

RO 

SECOND 

•N.RO 

-(R1>.R3 

•-1.R2 


R0.R3 

FOURTH 

R0.R3 

R3.8R1 


THIRD 

-<R1>.R0 

•10..R0 


BCC FIFTt 

ADD BIO.- 

.TTYOUT 
CLR BRl 

DEC R5 

BNE FIRS' 

.EXIT 


50 

51 000342 
000345 
000350 
000353 
00035* 
0003*1 
0003*4 

SUM.MAC VERSION 1 


.REPT 

.HORD 

.ENDR 


Nfl 


IPRINT INTRODUCTORY TEXT 
»N0. OF CHARS OF ’£• TO PRINT 
INO. OF DIGITS OF-ACCURACY 
•ADDRESS OF DIGIT VECTOR 
IDO MULTIPLY BY 10 <DECINAL) 
•SAVE «2 
1*4 
1*8 

•NOW *10. POINT TO NEXT DIGIT 
lAT END OF DIGITS? 

•BRANCH IF NOT 

•00 THRU ALL PLACES. DIVIDING 
•BY THE PLACES INDEX 
UNIT QUOTIENT REGISTER 
•BUMP QUOTIENT 

•SUBTRACT LOOP ISN'T BAD 

•NUMERATOR IS ALHAYS < 10*N 

•FIX REMAINDER 

•SAVE REMAINDER AS BASIS 

•FOR NEXT DIGIT 

•GREATEST INTEGER CARRIES 

•TO GIVE DIGIT 

•AT END OF DIGIT VECTOR? 

•BRANCH IF NOT 

•GET DIGIT TO OUTPUT 

•FIX THE 2.7 TO .7 SO 

•THAT IT IS ONLY 1 DIGIT 

•(REALLY DIVIDE BY 10) 

•MAKE DIGIT ASCII 
•OUTPUT THE DIGIT 
•CLEAR NEXT DIGIT LOCATION 
•MORE DIGITS TO PRINT? 

•BRANCH IF YES 
• WE ARE DONE 


UNIT VECTOR TO ALL ONES 


040 

114 

040 

040 


12 * 

125 

117 

105 

123 

012 


105 MESSAG: .ASCII /THE VALUE OF E IS:/ <15><12> /2./ <200> 
101 
105 
10 * 

040 
072 
0*2 


MACRO Ve5.00 Saturdaw 08-Jan-83 08:07 Pa*e 1-1 


54 OOOOOO' 

iSUM.MAC VERSION 1 
SwMbol table 


MACRO V05.00 


EXP OOOOOOR 

. ABS. OOOOOO 000 

000372 001 

Errors detected: 0 

*** Assembler statistics 

HorK. file reads: 0 
Uarl<^ file writes: O 

Size of 4«orK file: 8222 Words < S3 Pases) 
Size of core rool: 15*1* Words < *1 Paaes) 
Oreretina swstee: RT-11 


THIRD 000044R 


I-Jan-83 0S:07 Paae S-1 


EXP 

FIFTH 

FIRST 

FOURTH 

MESSAG 


1-14 

l-ll* 

1-37* 

1-13* 

l-25« 

1-11 

1-7* 

1-15* 

1-23* 


1-47* 

1-54 

1-39 

1-44 

1-28 

1-51* 

1-12 

1-21 

1-35 
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8UH.HAC VERSION t NACftO VOS.00 SaturdM OO^Jan-OS 00107 Raoa- H-i 

Cream rafareoce taOla (CftCF V05.00) 


.EXIT t-30^ 
.miNT t>M 
.TTYOU t-30 


.LINK/NAP Sim 
OT-lt LINK VOO.OO 
SUM .SAV Tiitat 


Lead Naa^ Saturday OO-Jan-OS^OOttt Made 1 

SUN.HA Idantt 


Saciien Addr Siaa Blebal Value Olebal Valua Olebal Valua 

. ABS. 000000 001000 - 2S«. uerda (RU.I.BBLrABSrOVR) 

001000 000372 - 12S. Morda (RUrlttCLrllCLfCON) 

Tranafar addraaa • OOlOOOt Hlah Halt » 001370 • 380. werda 


.RENAME MATCH.BAS MATCH.NAP 
.NACR0/LIST/CR088REFCRENCE DENOFQ 

DENOFB MACRO VOS.00 Saturdaw OB-Jan-83^081It Pada 1 




8 OOOOOO 

? oooooa 

10 000020 

11 OOOOS4 

12 

13 

14 

15 000042 
14 000070 

17 000072 

18 000124 

19 000132 

20 000144 

21 
22 


30 000174 

31 000240 

32 000324 


.TITLE DENOPO 
.IDENT /VOS.00/ 

r FOREGROUND DEMONSTRATION PROGRAM TO PRINT MESSAGE TO BACKGROUND. THEN 
• QUEUE A MESSAGE EVERY 2 SECONDS FOR THE BACKGROUND TO RING THE BELL. 

.NCALL .8DATC..PRINT..HRKT>.08CTt.SPND 

IPRINT INTRODUCTORY MESSAGE 
ISET ASIDE 100 0 ELEMENTS FOR MESSAGES 
»8ET UP MKTIM FOR 2 SECONDS FROM NOW 
♦SUSPEND THE FO TILL MKTIM SATISFIED 


MKTIM COMPLETION ROUTINE 


000132 HKTCt 


00S247 0O02S0 

000207 


104 117 

123 lOS 

105 124 


CMP 

BOT 

.SDATC 


MSGCNT.aYO. 

NKTCl 

•AREA.•BUFFER. •1.BSOATC 
MSGCNT 

•AREA.BTIME.BMKTC.BI 


190 MESSAGES QUEUED YET? 

♦YES-NO SENSE QUEUEING ANOTHER 

♦SEND MESSAGE TO BG 

♦BUMP MESSAGE COUNTER 

♦SET UP ANOTHER MKTIM FOR 2 SECONDS 

♦RETURN FROM COMPLETION ROUTINE 


SDAT COMPLETION ROUTINE 
DEC MSGCNT 


35 000402 OOOOOO 


41 000410 

42 

43 000424 


MSG: .ASCII 

.ASCII 
.ASCIZ 
.EVEN 

MSGCNT: .WORD 


area: 

buffer: 


BLKU 4 
BLKU 400 


/FOREGROUND DEMONSTRATION PR0GRAM/<1S><12> 

/SENDS A MESSAGE TO THE BACKGROUND PROGRAM •DEM0BGV<15><12> 
/EVERY 2 SECONDS. TELLING IT TO RING THE BELL./ 


♦MESSAGE COUNTER 

♦TIME CONSTANT 
♦ HIGH ORDER 

♦40 TICKS A SECOND.2 SECONDS 
♦EMT ARGUMENT AREA 
♦BUFFER FOR MESSAGES 


48 OOOOOO' .END 

DEMOFO MACRO VOS.00 Saturday 08-Jan-83 08:11 Pada : 
Swabol table 


100 .* 10 . 
START 


AREA 00041OR 
BUFFER 000424R 
MKTC 000042R 


MKTCl 000132R 
MSG 000174R 
MSGCNT 000402R 


. ABS. OOOOOO 000 (RH.I.GBL.ABS.OVR) 

005344 001 (RW.l.LCL.REL.CON) 

Errora datactad: 0 


••• Aaaaablar atatiatica 

UorK file raadal 0 
Work file writaal 0 

Size of work filaJ 9384 Horde ( 37 Padaa) 

Size of a-ra rooll 15414 Horde ( 41 Padaa) 

Oaarattnd awataal RT-11 

Elaaaad ilaat 00102:27.42 

DK:DCMOFG.LP:DEMOFB-DK1DEMOFG/C 

DEMOFG MACRO VOS.00 Saturdaw 08-Jan-83 08:11 Pada S-1 
Croaa rafaranca table (CREF VOS.00) 



...VI 

...V2 

AREA 

BUFFER 

MKTC 

NKTCl 

MSG 

MSGCNT 

QUEUE 

SDATC 

START 

TIME 

DEMOFG 

Croaa i 


1-17 

1-80 

1-10 


1-10 

1-17 

1-17 

1-43B 

I-ISB 

1-19B 

1-300 

1-18* 

1-440 

1-240 

1-48 

1-19 


1-17 

1-170 

1-19 


1-380 

MACRO VOS.00 Saturdaw 08-Jan-83 08111 Pada M-1 
•afaranca table (CREF VOS.00T 



...CHO 1-9 

...CMl 1-17 

...CH2 1-10 1-10 

...CN4 1-17 

...CMS 1-9 1-10 

...CM4 1-10 1-19 

.MRKT L-40 1-10 

.PRINT 1-40 1-8 

.QSET 1-40 1-9 

.SDATC 1-40 1-17 

.SPND 1-40 1-11 


1-10 1-17 1-17 

1-17 1-19 

1-19 


1-17 1-17 1-19 


.LINK/FOREGROUND/NAP DEMOFG 

RT-11 LINK V08.00 Load Mar Saturdaw 08-Jan-83 08115 Pada 1 

DEMOFG.REL Tttlat DEMOFG Idant: VOS.00 


Sactlan 


Size Global Value Global Value Global Valua 


. ABS. OOOOOO 001000 > 254. 

001000 00S344 - 1394. 

START 


worde (RH.I.GBL.ABS.OVR) 
worda (RH.I.LCL.REL.CON) 
001000 


Tranafar addraaa ■ 001000. Hidh Halt » 004342 ■ 1449. worda 


.DIRECTORY B.OBJ 
08-Jar.-83 
ODT .OBJ 8 

VTH0LR.0BJ 8 

ERROUT.OBJ IS 

TEST .OBJ 1 

DEMOFO .OBJ 
10 Filaa 


354 Free blocka 


8 22-0ct-82 

8 22-0ct-82 

13 22-0ct-82 

1 08-Jan-83 

1 08-Jan-B3 

24S Blocka 


VDT .OBJ 
SYSLIB.OBJ 
FORLIB.OBJ 
SUM .OBJ 
GRAPH .OBJ 


8 22-0ct-e2 

44 22-0ct-82 

141 12-Haw-80 

1 08-Jan-83 

14 08-Jan-83 


.DELETE/NOQUERY GRAPH.* 
.DELETE/NOQUERY SUM.S 


.DELETE NATCH.MAP 


1-19 1-19 
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.KA88I0N 

.TINE 

«Stl9t«4 

SUMMARY: 
COMMANDS TO 

START AN 

INDIRECT FILE 

©filnam.COM 

Start the execution of the specified indirect file 
(filnam.COM). 

CTRL/C CTRL/C 

Halt execution of the indirect command file (use with cau¬ 
tion). 

DEASSIGN 

Remove logical device assignments. 

FILE MAINTENANCE 

Indirect file INDCT.COM contains commands that perform the 
appropriate copy and delete file maintenance operations. If the 
commands were not already part of the file, you would need to 
perform the appropriate file maintenance commands, in mon¬ 
itor command mode, after execution. 

REFERENCE 

RT-ll System User's Guide (AA-5279C-TC). Maynard, Mass.; Digital Equip¬ 
ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 
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CHAPTER 17 
ADVICE TO NEW USERS 


This manual introduces several common RT-11 functions but is 
neither exhaustive nor comprehensive in its treatment of 
system features, commands, or their options. For many users, 
this manual’s description of these fundamental system opera¬ 
tions is sufficient; other users, however, may need or want fur¬ 
ther description of a programming language, extended system 
features, or the internal workings of the RT-11 system. These 
people should consult the references at the end of each chapter, 
the Guide to RT-11 Documentation, RT-11 System Usefs 
Guide, or the RT-11 System Utilities Manual. The Guide to 
RT-11 Documentation lists all RT-ll-related material avail¬ 
able from DIGITAL; the RT—11 System User’s Guide explains 
in detail monitor commands and command options; the RT-11 
System Utilities Manual describes the use of the RT-11 system 
utilities to develop programs, execute programs, and maintain 
files and storage media. 

The Introduction to RT—11 has shown you the right way to use 
some important system features and their associated monitor 
commands. This information, combined with the following basic 
guidelines for using the system, can help you to avoid pitfalls 
common to new users: 

• Do not become dependent on a single copy of a file. Always 
make a backup copy of any useful file. 

• When using the editor, close files periodically to preserve 
edits. Divide long editing sessions into short ones so that 
user — or hardware — errors do not lose the efforts of long 
hours of editing. Close the file with the EX command and 
begin editing again from where you left off. 

• Avoid careless use of wildcard operations that manipulate 
multiple files. Use the /QUERY option to verify the operation 
to be performed. 

• When using indirect files or BATCH streams, avoid opera¬ 
tions that manipulate any of the system (.SYS) files or the 
indirect file in use. Check the indirect file carefully for er rors 
before you use it. Once the command stream is initiated, you 
may be unable to detect and prevent possibly serious errors. 

• If you run two jobs under the control of the foreground/back¬ 
ground monitor, be sure there is no conflict of nondirectory- 
structured devices (LP:, MT:, TT:) used by the two jobs. 
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USING THE 
HELP FILE 


HELP 


A HELP file containing infomation about the keyboard mon¬ 
itor commands and how to use them is distributed with the 
RT-11 system. A list of keyboard monitor commands and a de- 
scription of their functions can be displayed at the terminal by 
typing: 

.HELP *isai 

To get a detailed description of the use of the HELP command 
itself, type only HELP. 

•HELP® 

The following information is displayed on your terminal. 


HELP Lifts helpful information 

SYNTAX 

HELPC/oPtionsK toPicC subtopicC:iterns.. 
or HELP * 


...11 



SEMANTICS 

HELP * lists the items for whioh help is 
available* 

HELP lists the HELP tent (of uhich this is a 
part)* 

HELP topic lists information on the specific 
topic only* 

HELP topic subtoPic lists information on the 
specific subtopic only (for example* 

HELP HELP SEMANTICS lists the paragraph of 
which this text is a part)* 

HELP topic subtopics item lists only the text 
associated with the specific item* 

HELP topic/item lists the text associated with 
the specific item under the subtopic OPTIONS* 

Ualid topics are the Keyboard monitor commands 

Subtopics are "SYNTAX”» "SEMANTICS"* "OPTIONS" 
and "EXAMPLES"* 

Items are specific command options* 



OPTIONS 

PRINTER 

Prints the HELP text on the line printe 
TERMINAL (default) 

Types the HELP text on the terminal 


r 



EXAMPLES 
HELP COPY 

help/printer execute 

HELP PRINT OPTION;COPIES 
HELP COPY/BOOT/DEUICE 


!Lists information about 
ICOPY command 
IPrints information 
•about EXECUTE command 
•Describes the COPIES 
• option for PRINT 
•Describes the listed 
{options for COPY 


In the command syntax shown above, topic represents a specific 
keyboard monitor command about which you need information. 
The subtopic represents a specific category within a topic; the 
subtopics are syntax, semantics, options, and examples. The 
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item represents one of the members within the subtopic group. 
You cnn specify more then one item in the commnnd line if you 
separate the items with a colon (:). 

The only two options you can use with the HELP command are 
/PRINTER and /TERMINAL. The option /PRINTER sends the 
help information to a printer if one is available. The option 
/TERMINAL (the default mode) sends the information to the 
terminal. 

To get all the information in the help file about the keyboard 
monitor command ASSIGN, type the following command: 


'help assign® 

You have used this command in examples in the other chapters. 
The following information is displayed at your terminal: 

ASSIGN Associates a logical device name with a 
Physical device 

SYNTAX 

ASSIGN physical<-device-name losical-device^name 
SEMANTICS 

Physical-deVice-name is the RT-11 standard 
permanent name for the device* 

Losi cal-device-name is one to three alphanumeric 
characters Ions with no intervenins spaces or tabs* 

The Physical name and losical name must be 
separated by a space* 

OPTIONS 

None 

EXAMPLES 

ASSIGN RKl: OK: 


When you want specific information for a keyboard monitor 
command, such as the syntax, semantics, options, or examples, 
include that subtopic in the command. For example, the fol¬ 
lowing command lists all the options that are available for use 
with the DIRECTORY keyboard monitor command: 


'help directory options® 

If you need information only about a specific item in a list of 
options, type the item in the command line. 

'help directory 0PTI0NS:0RDER® 

ORDERC:cate so ry1 

Orders the directory listin* accordin* to the catefory 
specifyi same as /SORT* CateSories are: 

NAME- orders alphabetically by file name 
TYPE- orders alphabetically by file type 
SIZE- orders by file size 
OATE— orders by creation date 

POSITION- orders by file position on the device 
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APPENDIX A 

MANUAL BOOTSTRAPPING OPERATIONS 


PDP 11 computers that do not have the automatic bootstrap¬ 
ping capability described in Chapter 2 require manual 
bootstrapping. This appendix’s first section, Bootstrapping the 
System, provides information that you will need to bootstrap 
the system manually. Follow the procedure described in this 
section; you will be referred — if appropriate for your 
system to one of the other sections, which describe using a 
pushbutton console to bootstrap, using a switch register console 
to bootstrap, and typing the bootstrap. 


Once you have identified your hardware configuration, you are 

ready to bootstrap the system. The purpose of the bootstrap 

procedure is to load and start the RT-11 monitor in computer 

memory, activating the RT—11 operating system for your use. 

1. Set the terminal to an on-line condition. 

2. Make sure that the computer power is on and that the com¬ 
puter is not already in use. Stop the computer, following 
one of two procedures: 

• If your operator’s console has switches, set the switches to 
HALT, then ENABLE. 

• If your operator’s console has pushbuttons, locate the 
button labeled CNTRL; hold it down and push the button 
labeled HLT/SS; then release both. 

3. Place the system volume in device unit 0. Make sure that 
the system volume is write-protected (for all except RXOl or 
RX02 diskettes, which are always write-enabled). 

4. Place the storage volume in the device unit you identified 
for question 8 in the Hardware Configuration section of 
Chapter 2. Make sure that this volume is write-enabled. 

5. If your operator’s console has pushbuttons, continue to step 

6. Otherwise, go to step 8. 

6. Locate the pushbutton labeled CNTRL, hold it down and 
push the button labeled BOOT. Check the terminal printer 
or screen. If there is no response, read the Using a Push¬ 
button Console to Bootstrap section of this appendix; other¬ 
wise, continue to step 7. 

7. Your terminal printer or screen should show several num¬ 
bers and then a dollar sign ($). 


BOOTSTRAPPING 
THE SYSTEM 
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Type on the terminal keyboard the two-letter mnemonic 
that represents your system volume (from question 6 in the 
Hardware Configuration section^) followed by a carriage re¬ 
turn, Be sure to use the SHIFT key so that you type upper¬ 
case characters. For example, for 1^02 diskette, type; 

♦ 

• OY® 

Continue to step 11. 

8. Check your switch console. If it has a three-way dial labeled 
DC OFF, DC ON, and STAND BY, go to step 9. If it has 
three individual switches labeled DC ON/OFF, EN¬ 
ABLE/HALT, and LTC ON/OFF, go to step 10. If it has a 
row of switches across the entire console, read the Using a 
Switch Register Console to Bootstrap section of this appen¬ 
dix. 

9. Set the three-way dial to DC ON. Then locate the BOOT 
switch (to the left of the dial) and raise it. Go to step 11. 

10. Put all three switches in the up position; then move the DC 
ON/OFF switch down and up and check the terminal re¬ 
sponse. 

• If the terminal displays the dollar sign ($), type on the 
keyboard the two-letter mnemonic that represents yovu- 
system volume (from question 6 in the Hardware Configu¬ 
ration section) followed by a carriage return. Be sure to 
use the SHIFT key so that you type uppercase characters. 
For example, for RX02 diskette, type: 

*DY® 

Continue to step 11. 

• Any other response indicates that you must type the boot¬ 
strap on the terminal keyboard. Read the Taping the 
Bootstrap on the Terminal Keyboard section of this ap¬ 
pendix. 

11. If your system has been successfully bootstrapped, a mes¬ 
sage like the following prints on the console terminal. 

RT-iiFB 005. xH (the xx’s represent numbers that have 

significance only for DIGITAL’s soft¬ 
ware development; you can ignore 
these numbers) 

‘The RK05 disk is anexception. Hardware bootstraps use DK, not RK, for 
RK05. 
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If the message indicating RT-llFB VOS does not appear, 
refer to Appendix B and read the section entitled Sugges¬ 
tions for Bootstrapping the System. 

The message indicates that the foreground/background 
monitor component of the RT-11 Version 5.0 operating 
system is active. Set the system volume to a write-enabled 
condition (for all except RXOl and RX02 diskettes, which 
are always write-enabled). 

You should now direct your attention to the console terminal, 
since system interaction continues on this device. Continue to 
Chapter 3. 


The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must type on the terminal 
keyboard. First, obtain the bootstrap from the RT-11 Installa¬ 
tion Guide, and copy the numbers into the space below: 


TYPING THE 
BOOTSTRAP 
ON THE TERMINAL 
KEYBOARD 


Now, follow the instructions below to type, on your terminal 
keyboard, the bootstrap (if you make a mistake, type the DE¬ 
LETE key on the terminal keyboard, once for each tjrping error, 
and then type the correct digit[s]): 

1. Type 001000. 

2. TjTJe slash (/). 

3. Type the first number in the bootstrap column. 

4. Type the LINE FEED key. 

5. T 5 T)e the next number in the bootstrap column. 

6. Repeat steps 4 and 5 until you have t 5 T)ed all the numbers 
in the column. 

7. IVpe the RETURN key. 

8. Type lOOOG. 

9. Continue to step 11 in the section entitled Bootstrapping 
the System in this appendix. 
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USING A 
PUSHBUTTON 
CONSOLE TO 
BOOTSTRAP 


If your computer has a pushbutton console similar to the one 
shown in Figure A-1, you can use the buttons to manually give 
the computer the information it needs to bootstrap the system. 



Figure A-1 Pushbutton Console 

The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must load into the com¬ 
puter using the pushbutton console. First, obtain the bootstrap 
of your system device from the RT-11 Installation Guide, and 
copy the numbers into the space provided below. If your system 
has a hardware bootstrap,^ the bootstrap will consist of only two 
numbers, which you should copy into the left-hand space; other¬ 
wise, the bootstrap will consist of two columns of numbers la¬ 
beled Location and Contents, which you should copy into the 
right-hand space: 

Hardware Bootstrap Other Bootstraps 

Load Address = 

Start Address = 

To activate the hardware bootstrap, use the pushbuttons to set 
the numbers as described in the following steps (if you make a 
mistake, push the button labeled CLR, then reenter the 
number): 

1. Push the appropriate buttons for the load address (read the 
number from left to right). 

2. Push LAD. 

3. Push the appropriate buttons for the start address (read the 
number from left to right). 

4. Push the button labeled CNTRL, and, while holding it 
down, push the button labeled START. 

5. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 


hardware bootstrap is bootstrapping information that is already in com¬ 
puter memory but that you must activate by entering a load address and a 
start address, each a six-digit number. 
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To activate other bootstraps, use the pushbuttons to set the 

numbers as described in the following steps (if you make a mis¬ 
take, push the button labeled CLR, then reenter the number): 

1. Push 1000 (read the number from left to right). 

2. Push LAD. 

3. Push the appropriate buttons for the first number in the 
Contents column (read the number from left to right). 

4. Push DEP; push CLR. 

5. Push the appropriate buttons for the next number in the 
Contents column (read the number from left to right). 

6. Repeat steps 4 and 5 until all numbers in the column have 
been used. 

7. Push 1000. 

8. Push LAD. 

9. Push the button labeled CNTRL, and, while holding it 
down, push the button labeled START. 

10. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 


If your computer has a switch register console similar to the 
one shown in Figure A-2, you can use the switches to manually 
give the computer the bootstrapping information it needs to 
start the system. 




Figure A-2 Switch Register Consoles 


Several switches on the console are spring-loaded. This means 
that the switch moves in only one direction and returns to its 
initial position after you use it. You must set the remaining 
switches either up or down as instructed. 


USING A 
SWITCH REGISTER 
CONSOLE 
TO BOOTSTRAP 






Manual Bootstrapping Operations 


The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must load into the com¬ 
puter using the switch register console. First, obtain the boot¬ 
strap of your system device from the RT-11 Installation Guide, 
and copy the numbers into the space provided below. If your 
system has a hardware bootstrap,' the bootstrap consists of only 
two numbers, which you should copy into the left-hand space; 
otherwise, the bootstrap consists of two columns of numbers, 
labeled Location and Contents, which you should copy into the 
right-hand space: 


Hardware Bootstrap 

Load Address = 
Start Address = 


Other Bootstraps 


Next, convert the numbers in the column to binary numbers, 
using the conversion process shown in Table A-1. 

Table A—1 Binary Conversion 


Octal 


Binary 

0 

= 

000 

1 

= 

001 

2 

= 

010 

3 

= 

oil 

4 

= 

100 

5 

= 

101 

6 

= 

110 

7 

= 

111 


For example, the number 173100 is converted to 001 111 Oil 
001 000 000. You set this 18-digit binary number into the 
switch register by placing each individual switch in an up posi¬ 
tion for a 1 or a down position for a 0. The number 173100 is set 
into the switch register as follows: 


iit ttt itt iit ill iii 

The number 012700 is converted to 000 001 010 111 000 000 
and is set into the switch register as follows: 

Hi lit iU ttt Hi i i i 


hardware bootstrap is bootstrapping information that is already in com¬ 
puter memory but that you must activate by entering a load address and a 
start address, each a six-digit number. 
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c 

c 

c 


NOTE 

The switch register is the group of switches appearing on 
the left of the console. Your switch register may have 
only 16 switches rather than 18 ; in this case you can 
ignore the left-hand two digits of the binary number when 
you set the switches. 

To activate the hardware bootstrap: 

1. Set the switch register to the appropriate positions for the 
load address. 

2. Press the spring-loaded LOAD ADDR switch. 

3. Set the switch register to the appropriate positions for the 
start address. 

4. Press the spring-loaded START switch. 

5. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 

To activate other bootstraps, set the numbers into the switch 

register using the following method: 

1. Set the switch register to the appropriate positions for the 
number 001000. 

2. Press the spring-loaded LOAD ADDR switch. 

3. Set the switch register to the appropriate positions for the 
first number in the Contents column. 

4. Press the spring-loaded DEP switch. 

5. Set the switch register to the appropriate positions for the 
next number in the Contents column. 

6. Repeat steps 4 and 5 until all the numbers in the column 
have been used. 

7. Set the switch register to the appropriate positions for the 
number 001000. 

8. Press the spring-loaded LOAD ADDR switch. 

9. Press the spring-loaded START switch. 

10. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 
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SELECTED SYSTEM TOPICS 


The remarks in this appendix cover a variety of topics that 
should prove helpful to you as you perform the demonstrations 
in the manual. Included, for example, are instructions for 
starting and stopping the system, alternate methods for per¬ 
forming some system operations, and directions for using the 
language volume. The sections are listed here in the order in 
which they are referenced from within the text of the manual. 


You can plan to take a break at the end of any individual 
chapter in this manual. If you intend to be away from the com¬ 
puter system for any length of time, you should halt the system 
and remove your system and storage volumes. 


Perform the following steps in order: 

1. Stop the computer. 

• If your computer is a PDP-11/23-PLUS, lift the HALT 
toggle switch to the up position. 

• If your computer is a PDP-11/24 or a PDP-11/44, push 
the HALT/CONT/BOOT horizontal toggle switch to the 
HALT position. 

• If your computer operator’s console has switches, press the 
HALT switch. 

• If your computer operator’s console has pushbuttons, hold 
the CNTRL button down and push the HLT/SS button. 

2. Unload the system volume. Set the device unit to an off-line 
condition, and remove the system volume. 

3. Unload the storage volume. Set the device unit to an off¬ 
line condition, and remove the storage volume. 

4. Remove and save all terminal and line printer output list¬ 
ings. 


Perform the following steps in order: 

1. Follow the bootstrap procedure, as described in Chapter 2 or 
Appendix A. 
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2. Enter the current date and time-of-day (Chapter 4). 

3. Make any necessary logical device assignments. For the ex¬ 
amples in this manual, you must assign the logical name 
VOL: to your storage volume (Chapter 4). 

THE SYSTEM STOPS 
UNEXPECTEDLY 

If for any reason the computer system stops unexpectedly, re¬ 
quest help from an experienced user if possible. The problem 
may be accompanied by an error message (see the RT-11 
System Message Manual)-, the problem may be in the hardware, 
in the software, or in your program. Once the problem is diag¬ 
nosed and corrected, try to bootstrap the system again. 

SUGGESTIONS FOR 
BOOTSTRAPPING 

THE SYSTEM 

You must be able to bootstrap your RT-11 system before you 
can perform the demonstrations in this manual. Three common 
bootstrapping problems and suggestions for their correction 
follow. 

1. You cannot remember how to bootstrap your system. 

Ask an experienced RT-11 user to help you. If no one is 
available, read the bootstrapping instructions in the RT-11 
Automatic Installation Booklet or the RT-11 Installation 
Guide. If necessary consult the appropriate hardware man¬ 
uals for the devices that are part of your system; these man¬ 
uals provide a description of the device and operating proce¬ 
dures. Then try the bootstrap procedures again. 

2. You have followed the bootstrapping instructions correctly, 
but your system printed a message other than what you 
expected. 

a. The message can be one of the following: 

?BOOT-F-No boot on volume 

?BOOT-U-Coriflictin^ SYSGEN options 

?BOOT~U-Handler file not found 

?B00T-U-In5ufficient memory 

7B00T-U-I/0 error 

?BOOT-U-Mon i 1 0 r file not found 

7B00T-U-N0 Kill 

7B00T-U-Swap file too small 

7B00T-U-SWAP*SYS not found 
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7B00T-W-Error reading handler 
?BOOT-W-Invalid or missing TT*SYS 

These are bootstrap error messages, indicating that a 
problem in the system is preventing bootstrapping. 
These eleven messages are fully explained in the RT-11 
System Message Manual, but you should not try to cor¬ 
rect the problem yourself if an experienced user is avail¬ 
able to help. 

b. The message can be one of the following: 

RT-llSJ V05-XX I 

RT-llXM, 005-xx 

These indicate that a valid RT-11 V5 monitor program 
has been bootstrapped, but it is not the one you should 
be using. Reboot the correct monitor program by typing 
the following commands on the terminal: 

•500T® 

Device or file? RTlIFB.SYSffl 

c. Any other message indicates that an old version of 
RT-11 (VI, V2, V2B, V2C, V3, V3B, or V4) has been 
bootstrapped. Only Version 5 of RT-11 can be used to 
perform the demonstrations in this manual. 

3. You followed the bootstrapping instructions correctly, but 
nothing happened, that is, there was no terminal response 
at all. 

Repeat the bootstrap procedure from the beginning. Before 
you begin, make sure that the system volume is properly 
mounted in device unit 0. The computer should be on but 
not running (the light labeled RUN should not be on); if the 
computer is running, stop it as described above. Make sure 
that the terminal is on line and that its baud rate is set to 
300. If you are using a display terminal, make sure that the 
screen is bright enough for you to read. If your terminal 
uses a paper printer, make sure that the paper is properly 
loaded. 


A copy of the RT-11 Version 5 system volume, as distributed by 
DIGITAL, should be stored away for safekeeping as a backup 
copy. If you do not have a backup copy of your system volume, 
create one before you continue. Manual backup instructions are 
in the RT—11 Installation Guide', an experienced user should 
perform the backup operation. 
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DIRECTORY- VS 
NONDIRECTORY- 
STRUCTURED 
VOLUMES 


/ 


Storage volumes are called file-structured volumes because 
they are capable of physically storing files. These volumes can 
be further categorized as directory-structured and nondirectory- 
structured; the distinction is based on the method of directory 
information storage, collection, and printing. 

Directory information includes file names and types, dates of 
creation, and (in most cases) file lengths. When you type the 
DIRECTORY command, this directory information prints on 
your terminal. Volumes such as disks and diskettes keep this 
information in a single place at the beginning of the volume. 
Each time you add or delete a file, the directory information is 
updated. These volumes, which maintain a directory separately 
from the files described, are said to be directory-structured. 
Magtape volumes, on the other hand, do not keep directory in¬ 
formation in any single, separate place on the tape but rather 
with each individual file. For these volumes the directory infor¬ 
mation is collected for printing as each file is encountered 
during a sequential reading of all files on the tape. Thus, these 
volumes are said to be nondirectory-structured. 

You can list the directory from either type of volume in com¬ 
plete or abbreviated format. Complete directories include the 
file name, file type, file length, and date of creation (if the 
DATE command was used before the file’s creation). For most 
volumes, the directory format is as follows: 

e- Jan-e3 

FILE .TYP 2B 21-Feb-80 

Abbreviated directories include only the file name and file type, 
and are printed in five columns. For more information about 
directory-structured and nondirectory-structured volumes, see 
the RT—11 System User’s Guide. 


ALTERNATE 
RENAME 
OPERATION FOR 
MAGTAPE USERS 


You cannot use the RENAME monitor command if your volume 
is a magtape because of the magtape’s sequential (nondirectory- 
structured) nature. To perform the RENAME operation, you 
must first copy the file, using the new file name, and then de¬ 
lete the old file. 

For example, to change the name of the GRAPH.TWO file, lo¬ 
cated on your storage volume, to GRAPH.FOR, first make a 
copy of GRAPH.TWO, giving the new file the name 
GRAPH.FOR. 

Long Command Format 

.coPYiB) 

From? MOL:GRAPH.TWO® 

To ? GRAPH.FOR® 
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COPY VOLrGRAPH.TWO GRAPH.FOR® 
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You now have two copies of the GRAPH file. Delete the one not 
wanted, using the monitor DELETE command. (This command 
is described in Chapter 7 in the section entitled File Delete 
Operations.) 


Long Command Format 

DELETE® 

• VOL:GRAPH.TWO® 

Files? 


Short Command Format 

DELETE OOLiGRAPH.TWO® 


A single copy of GRAPH.FOR now resides on your system 
volume. Copy the file onto your storage volume. 


Long Command Format 

COPY® 

• GRAPH.FOR® 

From? OOL:GRAPH. FOR® 

To ? 


Short Command Format 

COPY GRAPH.FOR OOL ! GRAPH . FOR® 

« 

Delete the original file. 


Long Command Format 

DELETE® 

• GRAPH.FOR® 

Files? 


Short Command Format 

DELETE GRAPH.FOR® 


The combined effect of these four commands is to "rename” 
GRAPH.TWO to GRAPH.FOR. 


The FORTRAN/BASIC language volume was created during 
system installation specifically for your use with this manual. 
This volume contains the FORTRAN IV and/or BASIC-11 lan¬ 
guage processors and the monitor files required to use these 
language processors. Before you can perform the FORTRAN IV 
or BASKU—11 demonstrations, you must substitute this 


USING THE 
FORTRAN/BASIC 
LANGUAGE VOLUME 
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FORTRAN/BASIC language volume for the system volume cur¬ 
rently mounted in device unit 0. The language volume then 
serves as the system volume during the course of the FOR¬ 
TRAN IV and BASIC-11 demonstrations. 

Make sure that no system operations are in progress (the mon¬ 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the language volume. Bootstrap the system (see Stop¬ 
ping and Starting the System, this appendix). The following 
monitor message should appear: 

RT-llFB 005.XX 

Write-enable the volume. Then enter the current date and 
time-of-day, and assign the logical name VOL: to your storap 
volume, just as you did in Chapter 4. When you have done this, 
you are ready to run the language demonstration. Return to the 
main text of this manual. 


SUBSTITUTING 

VOLUMES 

DURING 

OPERATIONS 


Users of FORTRAN IV on diskette who have the FORTRAN IV 
language processor on a volume apart from their system 
volume must occasionally copy files and substitute volumes. 
These operations are necessary when files needed are not stored 
on a currently mounted volume. The appropriate volume, con¬ 
taining needed files, must be substituted for a currently 
mounted volume. If the volume to be dismounted contains nec¬ 
essary files, these files must be copied to a volume that will 
remain mounted. 

For example, before you can compile the FORTRAN IV file 
THIRD.FOR, you must substitute the language volume con¬ 
taining the FORTRAN IV compiler for the system volume cur¬ 
rently loaded in device unit 0. First, however, you must copy 
the file THIRD.FOR to your storage volume so that it will be 
available for use. 

Long Command Format 

COPY® 

• THIRD.FOR® 

From? VOL;THIRD.FOR® 

To ? 

Short Command Format 

COPY THIRD.FOR 00L:THIRD.F0R® 
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When the copy operation is finished, stop the system, remove 
the system volume currently loaded in unit 0, and insert and 
write-protect the language volume. See Stopping and Starting 
the System (this appendix) if necessary. The following message 
appears when the language volume is bootstrapped. 

RT-11F6 005. XX 

Write-enable the volume. Fhen enter the current date and 
time-of-day, and assign loipcal name VOL: to your storage 
volume, as described in Cha pter 4. 

Next, compile the FORTRAN IV program THIRD.FOR, which 
is now on VOL:. 

Long Command Format 

FORTRAN® 

Files? OOLs THIRD. FOR® 

PUTSTR 

Short Command Format 

FORTRAN OOLiTHIRD® 

PUTSTR 

The FORTRAN command causes the object module to be cre¬ 
ated on the default storage volume, which is presently the 
system volume (that is, the language volume). Any errors that 
occur during the compile operation indicate that the source file, 
THIRD.FOR, contains typographical errors. You must edit the 
file to correct any errors, recompile, and then copy the file to 
VOL:. Once you have an object module compiled without error 
and stored on VOL:, reload the main system volume in unit 0. 
Follow the directions in Stopping and Starting the System. 
Bootstrap and write-enable the system volume, enter the cur¬ 
rent date and time-of-day, and assign the logical name VOL: to 
your storage volume. 

Now copy the object module on VOL: back to the system 
volume. 

Long Command Format 

.COPY® 

From? VOLiTHIRD OBJ® 

To ? THIRD.OBJ® 

Short Command Format 

.COPY VOLsTHIRD.OBJ THIRD.OBJ® 

Continue to Chapter 13, to the section entitled Building the 
Object Library. 
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USING THE 
LINK VOLUME 


The LINK volume was created during system installation for 
you to use with this manual. This volume contains the linker, 
LINK.SAV, and the system subroutine library, SYSLIB.OBJ. 
Before you can perform the linking demonstrations in Chapters 
9 and 12, you must substitute this LINK volume for your cur¬ 
rent system volume, which is mounted in device unit 0. The 
LINK volume then serves as the system volume during the 
course of the linking demonstration. 

First, transfer the object file you need to link to the storage 
volume. 

Long Command Format 

‘COPY® 

From? graph.OBJ® 

M0L:GRAPH.0BJ® 

Short Command Format 

•COPY GRAPH.OBJ VOL:GRAPH.OBJ® 

Make sure that no system operations are in progress (the mon¬ 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the LINK volume. Bootstrap the system. The following 
monitor message should appear: 

RT-llFB VOS.XX 

Write-enable the volume. Then enter the current date and time, 
and assign the logical name VOL: to your storage volume, just 
as you did in Chapter 4. 

Finally, transfer the object file from the storage volume to the 
system volume. 

Long Command Format 

•COPY® 

From? ooL:GRAPH.OBJ® 

’ GRAPH.OBJ® 

Short Conunand Format 

COPY V0L:GRAPH.0BJ GRAPH.OBJ® 

When you have done this, you are ready to run the linking 
demonstration. Return to the main text of this manual. 
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Follow the file maintenance operations outlined in this section 
if you substituted both a FORTRAN IV language volume and a 
LINK volume to perform the demonstrations in Chapter 9. 

First, mount the FORTRAN IV language volume in device unit 
0. If you do not remember how to do this, follow the instructions 
in the section of this appendix entitled Using the FORTRAN/ 
BASIC Language Volume. 

Next, obtain a directory listing of all the files on your FOR¬ 
TRAN IV volume that have the name GRAPH, regardless of 
file type; these files were generated as a result of the exercises 
in Chapter 9. 

Long and Short Command Formats 
. Directory graph.*® 

8-Jan-83 

GRAPH .BAK 2 08-Jan-83 GRAPH .FOR 2 08-Jan-83 

GRAPH .OBJ 16 08-Jan-83 GRAPH .LSI 8 08-Jan-83 

4Files» 28 Blocks 
48 Free blocks 

Since you have corrected errors in the source file GRAPH.FOR, 
the version on your storage volume is obsolete. Transfer the 
corrected GRAPH.FOR file from your system volume to VOL:, 
thus replacing the obsolete file. 

Long Command Format 

. COPY® 

From? GRAPH.FOR® 

To ? VOL: GRAPH. FOR® 

Short Command Format 

. COPY GRAPH.FOR VOL:GRAPH.FOR® 

Next, transfer GRAPH.LST to your storage volume. This en¬ 
ables you to examine the listing without having to recompile 
the program. 

Long Command Format 

, COPY® 

From? GRAPH.LST® 

To ? VOL: GRAPH.LST® 

Short Command Format 
. COPY GRAPH.LST VOL:GRAPH.LST® 


Once you have transferred all valuable files to your storage 
volume, delete the unnecessary files from the system volume. 
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Long Command Format 

• DELETE® 

Files? graph.#® 

Files deleted: 

DK.GRAPH.BAK ? y® 

DK.GRAPH.FOR ? y® 

DK.GRAPH.OBJ ? y® 

DK.GRAPH.LST ? y® 

Short Command Format 

• DELETE GRAPH.#® 

Files deleted: 

DK.GRAPH.BAK ? y® 

DK.GRAPH.FOR ? y® 

DK.GRAPH.OBJ ? y® 

DK.GRAPH.LST ? y® 

Make sure that no system operations are in progress (the mon¬ 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the LINK volume. Bootstrap the system (see Stopping 
and Starting the System, this appendix). The following monitor 
message should appear: 

RT-llFB 005.XX 

Write-enable the volume. Then enter the current date and time, 
and assign the logical name VOL: to your storage volume, just 
as you did in Chapter 4, 

Obtain a directory of all files on the system volume that have 
the name GRAPH, regardless of file type; these files were cre¬ 
ated as a result of the linking demonstrations in Chapter 9. 

Long and Short Command Formats 

• DIRECTORY GRAPH.#® 

8-Jan-83 

GRAPH .OBJ 14 08-Jan-83 GRAPH .SAV 19 08-Jan-83 

2 Files. 33 Blocks 
80 Free blocks 

Transfer GRAPH.SAV to your storage volume. Because 
GRAPH.SAV is an executable file, you can run the program 
without relinking it. 

Long Command Format 

d:oPY® 

From? GRAPH.SAV® 

To ? VOL:GRAPH.SAV® 
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Short Command Format 
, COPY GRAPH.SAV VOLiGRAPH.SAV® 

Next, delete the unnecessary files from your system volume. 

Long Command Format 

, DELETE® 

Files? GRAPH.OBJ .GRAPH.SAV® 

Short Command Format 

. DELETE GRAPH.OBJ.GRAPH.SAV® 

Finally, list the up-to-date directory of your storage volume so 
that you can see its current status. 

, DIRECTORY VOL:® 


Leave the LINK volume mounted in device unit 0, and proceed 
to Chapter 12, Linking Object Programs. 
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Absolute address 

The binary number that is assigned as the address of a 
physical memory storage location. 

Absolute section 

The portion of a program in which the programmer has 
specified physical memory locations of data items. 

Access time 

The interval between the instant at which data is re¬ 
quested from or for a storage device and the instant at 
which the data actually begins moving to or from the 
device. 

AOC (Analog to Digital Converter) 

A circuit that converts analog (voltage) signals to binary 
data. 

Address 

A label, name, or number that designates a location in 
memory where information is stored. 

Algorithm 

A prescribed set of well-defined rules or processes for the 
solution of a problem in a finite number of steps. 

Alphanumeric 

The subset of ASCII characters including the 26 alpha¬ 
betic characters and the 10 numeric characters. 

ANSI 

American National Standards Institute. 

Application program (or package) 

A program that performs a function specific to the needs 
of a particular end-user or class of end-users. An applica¬ 
tion program can be any program that is not part of the 
basic operating system. 

Argument 

A variable or constant value supplied with a command 
that controls the command’s action, specifically its loca¬ 
tion, direction, or range. 

Array 

An ordered arrangement of subscripted variables. 
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ASCII 

The American Standard Code for Information Inter¬ 
change; a standard code consisting of eight-bit coded 
characters for upper- and lower-case letters, numbers, 
punctuation, and special communication control charac¬ 
ters. 

Assembler 

A program that translates symbolic source code into ma¬ 
chine instructions. This program replaces symbolic oper¬ 
ation codes with binary operation codes and symbolic 
addresses with absolute or relocatable addresses. 

Assembly language 

A symbolic programming language that can be trans¬ 
lated directly into machine language instructions and is 
specific to a given type of control processing unit. 

Assembly listing 

A listing, produced by an assembler, that shows the 
symbolic code written by a programmer next to a repre¬ 
sentation of the actual machine instructions generated. 

Asynchronous 

The type of operation that is triggered by another event, 
as opposed to synchronous, or occurring at set time in¬ 
tervals. 

Background program 

A program that runs at a low priority, that is, when a 
higher priority (foreground) program is not using system 
resources. 

Backup file 

A copy of a file, created as a precaution against loss of 
the primary file. 

Base address 

An address used as the basis for computing the value of 
some other relative address; the address of the first loca¬ 
tion of a program or data area. 

BASIC-11 (Beginner’s All-purpose Symbolic Instruction Code) 

An interactive, algebraic computer language that com¬ 
bines English words and decimal numbers. It is a widely 
available, standardized, simple beginner’s language ca¬ 
pable of handling industry and business applications. 

Batch processing 

A processing method in which programs are run consec¬ 
utively without operator intervention. 
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Baud 


A unit of measurement of transmission speed; bits per 
second. 


Binary 

The number system with a base of two; used by the in¬ 
ternal logic of all digital computers. 

Binary code 

A code that uses two distinct chsu’acters, usually the 
numbers 0 and 1. 


Bit 

A binary digit. The smallest unit of information in a 
binary system of notation. It corresponds to a 1 or 0 and 
to one digit position in a physical memory word. 

Biock 

A group of physically adjacent words or bytes of a size 
that is specific to a device. For input/output operations, 
the smallest addressable unit on a mass storage device. 

Bootstrap 

A technique or routine whose first instructions are suffi¬ 
cient to start a system of programs that bring an opera¬ 
ting system into memory. 

BOT (Beginning Of Tape) 

A reflective marker that is applied to the backside of 
magtape and identifies the beginning of the magtape’s 
recordable surface. 

Bottom address 

The lowest memory address into which a program is 
loaded. 

Breakpoint 

A location at which program operation is suspended to 
allow operator investigation. 

Buffer 

A storage area used to temporarily hold information 
being transferred between two devices or between a de¬ 
vice and memory. A buffer is often a special register or a 
designated area of memory. 

Bug 

A flaw in the design or implementation of a program; a 
problem that can cause erroneous results. 
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Bus 


A flat, flexible cable consisting of many transmission 
lines, or wires. It interconnects computer system compo¬ 
nents to provide communication paths for addresses, 
data, and control information. 

Byte 

The smallest memory-addressable unit of information. 
In a PDP-11 computer system, a byte is equivalent to 
eight bits. 

Call 

A transfer from one part of a program to another with 
the ability to return to the original program at the point 
of the call. 

Calling sequence 

A specified arrangement of the instructions and data 
necessary to pass parameters and control to a given sub¬ 
routine. 

Central processing unit (CPU) 

A hardware unit of a computer that includes main 
memory and the registers and circuits that control the 
interpretation and execution of instructions. 

Character 

A single letter, numeral, or symbol used to represent 
information. 

Character pointer 

The place where the next character typed will be en¬ 
tered. During editing, the character pointer indicates 
the place in an ASCII text file where the next character 
typed will be entered into the file. 

Clear 

To delete the contents of a storage location by replacing 
the contents, usually with Os or spaces. 

Clock 

A device within a computer system that keeps time, 
counts pulses, measures frequency, or generates regular 
periodic signals for synchronization. 

Code 

A system of symbols used to represent data or instruc¬ 
tions that are executed by a computer. 
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Coding 

The writing of instructions for a computer, using a 
system of symbols that is meaningful to a computer, an 
assembler, a compiler, or a language processor. 

Command 

A word, mnemonic, or character that, by virtue of its 
syntax in an input line, causes a computer system to 
perform a predefined operation. 

Command language 

The vocabulary used by a program or set of programs 
that directs the computer system to perform predefined 
operations. 

Command language interpreter 

The program that translates a predefined set of com¬ 
mands into instructions that a computer system can in¬ 
terpret. 

Command string 

A line of input entered into a computer system that gen¬ 
erally includes a command, one or more file specifica¬ 
tions, and optional qualifiers. 

Compile 

To produce binary code from the S)rmbolic instructions of 
a high-level source language. 

Compiler 

A program that translates a high-level source language 
into machine instructions. 

Computer 

A machine that can be programmed to execute a set of 
instructions. 

Computer program 

A plan or routine for solving a problem on a computer. 

Computer system 

A data processing system that consists of hardware de¬ 
vices, software programs, and documentation that de¬ 
scribes the operation of the system. 

Concatenation 

The joining of two or more strings of characters to pro¬ 
duce a single string. 
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Conditional assembly 

The assembly of certain parts of a symbolic program 
that occurs only when certain conditions are met during 
the assembly process. 

Configuration 

A selection of hardware devices, software routines, or 
programs that function together. 

Console terminal 

A keyboard terminal that acts as the primary interface 
between the computer operator and the computer 
system. The console terminal is used to initiate and di¬ 
rect system operations by running software on the com¬ 
puter. 

Constant 

A value that remains the same throughout a distinct 
operation. (Compare with Variable.) 

Context switching 

The saving of key registers and other memory areas be¬ 
fore switching between jobs with different modes of exe¬ 
cution. An example of context switching is the use of 
foreground/background programming. 

Conversational 

See Interactive. 

CPU 

See Central processing unit. 

Crash 

A hardware crash is the failure of a particular device to 
operate; the operation of an entire computer system may 
be affected. A software crash is the result of an opera¬ 
ting system malfunctioning; the system’s protection 
mechanisms may have failed or the software may not 
have executed correctly. 

Create 

To open, write data to, and close a file for the first time. 

Cross-reference listing 

A printed listing that identifies all references in a pro¬ 
gram to each specific symbol in a program. It includes a 
list of all the symbols used in a source program and the 
statements where the symbols are defined or used. 


Glossary-6 




Glossary 



o 



Current location counter 

A counter kept by an assembler to determine the ad¬ 
dress assigned to an instruction or constant being as¬ 
sembled. 

Data 

A term used to denote facts, numbers, letters, and sym¬ 
bols. Data are the basic elements of information that can 
be processed by a computer. 

Data base 

An organized collection of interrelated data items that 
allow one or more applications to process the items, 
while disregarding physical storage locations. 

Data collection 

To bring data from one or more locations to a central 
location for eventual processing. 

Debug 

To detect, locate, and correct coding or logic errors in a 
computer program. 

Default 

The value of an argument, operand, or field assumed by 
a program if not specifically supplied by the user. 


Define 

To assign a value to a variable or constant. 

Delimiter 

A character that separates, terminates, or organizes ele¬ 
ments of a character string, statement, or program. 


Device 

A hardware unit such as an I/O peripheral, magnetic 
tape drive, or line printer. 

Device control unit 

A hardware unit that electronically supervises one or 
more of the same type of devices. It acts as the link 
between the computer and the I/O devices. 

Device handler 

A routine that services and controls the hardware activi¬ 
ties of an I/O device. 

Device independence 

The ability to program I/O operations independently of 
the device for which the I/O is intended. 
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Device name 

A unique name that identifies each device unit on a 
system. It consists of a two-letter device mnemonic fol¬ 
lowed by an optional device unit number and a colon. 
For example, the common device name for RL02 disk 
drive unit 1 is DLl:. 

Device unit 

One of a set of similar peripheral devices. An example of 
a device unit is disk unit 0. It may be used synony¬ 
mously with volume. 

Diagnostice 

A set of procedures used to detect and isolate malfunc¬ 
tions and mistakes. 

Digit 

A character used to represent one of the non-negative 
integers smaller than the radix (for example, in decimal 
notation, one of the characters 0 to 9; in octal notation, 
one of the characters 0 to 7; in binary notation, one of 
the characters 0 and 1). 

Direct access 

See Random access. 

Directive 

Assembler directives are mnemonics in an assembly lan¬ 
guage source program that are recognized by the assem¬ 
bler as commands to control a specific assembly process. 

Directory 

A file in the form of a table containing the names of and 
pointers to files on a mass storage volume. 

Directory-structured 

A storage volume is directory structured if the directory 
at the beginning of the volume contains information (file 
name, file type, length, and date-of-creation) about all 
the files on the volume. Such volumes include all disks, 
diskettes, and DECtapes. 

Disk device 

An auxiliary storage device on which information can be 
read or written. 

Display 

A peripheral device used to represent data graphically; 
normally refers to some type of cathode-ray tube system. 
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Downtime 

The time interval during which a device or system is 
inoperative. 


Echo 

The printing of characters typed by the programmer on 
an I/O device such as a terminal. 

Edit 

To arrange and/or modify the format of data; for ex¬ 
ample, to insert or delete characters. 

Editor 

A program that allows the user to enter text into the 
computer and edit it. Editors are language-independent 
and will edit an 5 d;hing in character representation. 

Effective address 

The address used in the execution of a computer instruc¬ 
tion. 

Emuiator 

A hardware device that permits a program written for a 
specific computer system to be run on a different type of 
computer system. 

Entry point 

A location in a subroutine to which program control is 
transferred when the subroutine is called. 

EOT (End Of Tape) 

A reflective marker applied to the backside of magtape, 
which precedes the end of the reel. 

Error 

Any discrepancy between a computed, observed, or 
measured quantity and the specified value or condition. 

Execute 

To perform an instruction or run a program on the com¬ 
puter. 

Expression 

A combination of operands and operators that can be 
evaluated to a distinct result by a computing system. 

Extension 

The synonym used for file type. 
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External storage 

A storage medium other than main memory, for ex¬ 
ample, a disk or tape. 

Field 

A specified area of a record used for a particular cate¬ 
gory of data. 

FIFO (First In/First Out) 

A data manipulation method in which the first item 
stored is the first item processed. 

File 

A logical collection of data that is treated as a unit, occu¬ 
pies one or more blocks on a mass storage volume, and 
has an associated file name and type. 

File maintenance 

The activity of keeping a mass storage volume and its 
directory up to date by adding, changing, or deleting 
files. 

File name 

The alphanumeric character string assigned by a user to 
identify a file. It can be read by both an operating 
system and a user. A file name has a fixed maximum 
length that is system-dependent. (The maximum length 
in an RT-11 operating system is six characters, the first 
of which must be alphabetic. Spaces are not allowed.) 

File specification 

A name that uniquely identifies a file maintained in any 
operating system. A file specification generally consists 
of at least three components: a device name, a file name, 
and a file type. 

File-structured device 

A device on which data is organized into files. The de¬ 
vice usually contains a directory of the files stored on 
the volume. (For example, a disk is a file-structured de¬ 
vice, but a line printer is not.) 

File type 

The alphanumeric character string assigned to a file ei¬ 
ther by an operating system or a user. It can be read by 
both the operating system and the user. System-recog¬ 
nizable file types are used to identify files having the 
same format or tjq)e. If present in a file specification, a 
file type follows the file name in a file specification, sep¬ 
arated from the file name by a period. A file t 5 q)e has a 
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fixed maximum length that is system-dependent. The 
maximum in an RT-11 operating system is three char¬ 
acters, not including any spaces and excluding the pre¬ 
ceding period. 

Flag 

A variable or register used to record the status of a pro¬ 
gram or device; the detection of errors by a translating 
program. 

Floating point 

A number system in which the position of the radix 
point is indicated by the exponent part of a number and 
another part represents the significant digits or frac¬ 
tional portion of a number (for example, 5.39 X 10® — 
Decimal; 137.3 X 8' — Octal; 101.10 X 2'® — Binary). 

Flowchart 

A graphical representation for the definition, analysis, 
or solution of a problem, in which symbols are used to 
represent operations, data, flow, and equipment. 

Foreground 

The area in memory designated for use by a high- 
priority program. The program that gains the use of ma¬ 
chine facilities immediately upon request. 

FORTRAN IV (FORmula TRANslatlon) 

A problem-oriented language designed to permit scien¬ 
tists and engineers to express mathematical operations 
in a form with which they are familiar. It is also used in 
a variety of applications, including process control, in¬ 
formation retrieval, and commercial data processing. 

Full duplex 

In communication, pertaining to a simultaneous, two- 
way, independent, asynchronous transmission. 

Function 

An algorithm, accessible by name and contained in the 
system software, that performs commonly used opera¬ 
tions. For example, the square root calculation function. 

General register 

One of eight 16-bit internal registers in the PDF—11 
computer. These are used for temporary storage of data. 


Global 

A value defined in one program module and used in 
others. Globals are often referred to as entry points in 
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the module in which they are defined and as externals in 
the other modules that use them. 

Half duplex 

Pertaining to a communication system in which two- 
way communication is possible, but only one way at a 
time. 

Handler 

See Device handler. 

Hardware 

The physical equipment components of a computer 
system. 

Hardware bootstrap 

A bootstrap that is inherent in the hardware and need 
only be activated by specifying the appropriate load and 
start address. 

High-level language 

A programming language whose statements are trans¬ 
lated into more than one machine language instruction. 
Examples are BASIC-11 and FORTRAN IV. 

HIgh-order byte 

The most significant byte in a word. The high-order byte 
occupies bit positions 8 through 15 of a PDP-11 word 
and is always an odd address. 

Image mode 

A mode of data transfer in which each byte of data is 
transferred without any interpretation or data changes. 

Indirect address 

An address that specifies a storage location containing 
either a direct (effective) address or another indirect 
(pointer) address. 

Indirect file 

A file containing commands that are processed sequen¬ 
tially, and that could have been entered interactively at 
a terminal. 

Initialize 

To set counters, switches, or addresses to starting values 
at prescribed points in the execution of a program, par¬ 
ticularly in preparation for re-execution of a sequence of 
code. To format a volume in a particular file-structured 
format in preparation for use by an operating system. 
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Input 

The data to be processed; the process of transferring data 
from external storage to internal storage. 

Input/Output device 

A device attached to a computer that makes it possible 
to bring information into the computer or get informa¬ 
tion out. 

Instruction 

A coded command that tells the computer what to do and 
where to find the values it is to work with. A symbolic 
instruction looks like ordinary language. Symbolic in¬ 
structions must be changed into machine instructions 
before they can be executed by the computer. 

Interactive processing 

A technique of user/system communication in which the 
operating system immediately acknowledges and acts 
upon requests entered by the user at a terminal. Com¬ 
pare with batch processing. 

interface 

A shared boundary. An interface might be a hardware 
component to link two devices, or it might be a portion of 
storage or registers accessed by two or more computer 
programs. 

Internal storage 

The storage facilities that form an integral physical part 
of the computer and that are directly controlled by the 
computer; for example, the registers of the machine and 
main memory. 

Interpreter 

A computer program that translates and executes a 
source language statement before translating and exe¬ 
cuting the next statement. 

Interrupt 

A signal that, when activated, causes a transfer of con¬ 
trol to a specific location in memory and breaks the nor¬ 
mal fiow of control of the routine being executed. 

Interrupt-driven 

Software that uses the interrupt facility of a computer to 
handle I/O and responds to user requests: RT-11 is such 
a system. 
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Interrupt vector 

Two words containing the address of an interrupt ser¬ 
vice routine and the processor state at which that rou¬ 
tine is to execute. 

Iteration 

Repetition of a group of instructions. 

Job 

A group of data and control statements that does a unit 
of work. A program and all of its related subroutines, 
data, and control statements is an example; also, a batch 
control file. 

Label 

One or more characters used to identify a source lan¬ 
guage statement or line. 

Latency 

The time from the initiation of a transfer operation to 
the beginning of actual transfer; that is, verification 
plus search time. The delay while waiting for a rotating 
memory to reach a given location. 

Library 

A file containing one or more macro definitions or one or 
more relocatable object modules that are routines that 
can be incorporated into other programs. 

LIFO (Last In/FIrst Out) 

A data manipulation method in which the last item 
stored is the first item processed; a push-down stack. 

Light pen 

A device, resembling a pencil or stylus, that can detect a 
fluorescent cathode-ray tube (CRT) screen. The pen is 
used to input information to a CRT display system. 

Linkage 

The code that connects two separately coded routines 
and passes values and/or control between them. 

Linked file 

A file whose blocks are joined together by references 
rather than by consecutive locations. 


Linker 

A program that combines many relocatable object mod¬ 
ules into an executable module. It satisfies global refer¬ 
ences and combines program sections. 
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Listing 

The printed copy generated by a line printer or terminal. 

Load 

To store a program or data in memory. To place a vol¬ 
ume on a device unit and put the unit on line. 

Load map 

A table, produced by a linker, that provides information 
about a load module’s characteristics; for example, the 
transfer address, the global symbol values, and the low 
and high limits of the relocatable code. 

Load module 

A program in a format that is ready for loading and 
executing. 

Location 

An address in storage or memory where a unit of data or 
an instruction can be stored. 

Locked 

Pertaining to routines in memory that presently cannot 
be swapped or transferred. 

Logical device name 

An alphanumeric name assigned by the user to repre¬ 
sent a physical device. The name can then be used syn¬ 
onymously with the physical device name in all refer¬ 
ences to the device. Logical device names are used in 
device-independent systems to enable a program to refer 
to a logical device name assigned to a physical device at 
run-time. 


Loop 

A sequence of instructions that is executed repeatedly 
until a terminal condition prevails. 

Low-order byte 

The least significant byte in a word. The low-order byte 
occupies bit positions 0 through 7 in a PDP-11 word and 
is always an even address. 

Machine language 

The language used by the computer when performing 
operations. 


Macro 

An instruction in a source language that is equivalent to 
a specified sequence of assembler instructions, or a com- 


Glo88ary-15 






mand in a command language that is equivalent to a 
specified sequence of commands. 

Main program 

The module of a program that contains the instructions 
at which program execution begins. The main program 
usually exercises primary control over the operations 
performed; it also calls subroutines or subprograms to 
perform specific functions. 

Mask 

A combination of bits that is used to manipulate selected 
portions of any word, character, byte, or register while 
retaining other parts for use. 

Mass storage 

Pertaining to a device that can store large amounts of 
data that are readily accessible to the computer. 


Matrix 

A rectangular array of elements. Any matrix can be con¬ 
sidered an array. 

Memory 

Any form of data storage, including main memory and 
mass storage, in which data can be read and written. 
Memory usually refers to main memory. 

Memory image 

A replication of the contents of a portion of memory, 
usually in a file. 

Mnemonic 

An alphabetic easy-to-remember representation of a 
function or machine instruction. 

Monitor 

The master control program that observes, supervises, 
controls or verifies the operation of a computer system. 
The collection of routines that controls the operation of 
user and system programs, schedules operations, allo¬ 
cates resources, performs I/O, and so forth. 

Monitor command 

An instruction or command issued directly to a monitor 
from a user. 

Monitor command mode 

The state of the operating system — indicated by a pe¬ 
riod at the left margin — that allows monitor com¬ 
mands to be entered from the terminal. 
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Mount a volume 

To logically associate a physical mass storage medium 
with a physical device unit. To place a volume on a 
physical device unitj for example, to place a magtape on 
a magtape drive and put the drive on line. 

Multiprocessing 

Simultaneous execution of two or more computer, pro¬ 
grams by a computer which contains more than one cen¬ 
tral processor. 

Multiprogramming 

A processing method in which more than one task is in 
an executable state at any one time, even with one CPU. 

Nondirectory-structured 

Refers to a storage volume that is sequential in struc¬ 
ture and therefore has no volume directory at its begin¬ 
ning. File information (file name, file type, length, and 
date-of-creation) is provided with each file on the vol¬ 
ume. Such volumes include magtape and cassette. 

Non-file-structured device 

A device, such as a line printer or terminal, in which 
data cannot be organized as multiple files. 

Object code 

Relocatable machine language code. 

Object module 

The primary output of an assembler or compiler, which 
can be linked with other object modules and loaded into 
memory as a runnable program. The object module is 
composed of the relocatable machine language code, re¬ 
location information, and the corresponding global sym¬ 
bol table defining the use of symbols within the module. 

Object Time System (OTS) 

The collection of modules that is called by compiled code 
in order to perform various utility or supervisory opera¬ 
tions; for example, FORTRAN IV Object Time System. 

Octal 

Pertaining to the number system with a radix of eight; 
for example, octal 100 is decimal 64. 

ODT 

On-line Debugging Technique: an interactive program 
for finding and correcting errors in programs. 

Off-lina 

Pertaining to equipment or devices not currently under 
direct control of the computer. 
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Offset 


The difference between a base location and the location 
of an element related to the base location. The number 
of locations relative to the base of an array, string, or 
block. 

One’s complement 

A number formed by interchanging the bit polarities in 
a binary number; for example. Is become Os; Os become 
Is. 

On-line 

Pertaining to equipment or devices directly connected to 
and under control of the computer. 

Op-code (operation code) 

The part of a machine language instruction that identi¬ 
fies the operation the CPU is to perform. 

Operand 

The data that an instruction operates upon. An operand 
is usually identified by an address part of an instruction. 

Operating system 

The collection of programs, including a monitor and sys¬ 
tem programs, that organizes a central processor and 
peripheral devices into a working unit for the develop¬ 
ment and execution of application programs. 

Operation 

The act specified by a single computer instruction. A 
program step undertaken or executed by a computer; for 
example, addition, multiplication, comparison. The oper¬ 
ation is usually specified by the operator part of an in¬ 
struction. 

Operation code 

See Op-code. 

Operator’s console 

The set of switches and display lights used by an oper¬ 
ator or a programmer to determine the status of the 
computer system and to start the computer. 

Option 

An element of a command or command string that en¬ 
ables the user to select alternatives associated with the 
command. In the RT—11 operating system, an option 
consists of a slash character (/) followed by the option 
name and, optionally, a colon, and an option value. 
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Output 

The result of a process; the transferring of data from 
internal storage to external storage. 

Overflow 

A condition that occurs when a mathematical operation 
yields a result whose magnitude is larger than the hard¬ 
ware is capable of handling. 

Overlay segment 

A section of code treated as a unit that can overlay code 
already in memory and be overlaid by other overlay seg¬ 
ments when called from the root segment or another res¬ 
ident overlay segment. 

Overlay structure 

A program overlay system consisting of a root segment 
and optionally one or more overlay segments. 

Page 

That portion of a text file delimited by form feed charac¬ 
ters and generally 50 to 60 lines long. Corresponds ap¬ 
proximately to a physical page of a program listing. 

Parameter 

A variable that is given a constant value for a specific 
purpose or process. 

Parity 

A binary digit appended to an array of binary digits to 
make the sum of all bits always odd or always even. It is 
used to check the validity of data. 

Patch 

To modify a routine in a rough or expedient way, usually 
by modifying the binary code rather than by assembling 
it again. 

PC 

See Program counter. 

POP 

Programmable data processor. 

Peripheral device 

Any device distinct from the computer that can provide 
input and/or accept output from the computer. 

Physical device 

An I/O or peripheral storage device connected to or asso¬ 
ciated with a computer. 
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Priority 

A number, associated with a task, that determines the 
order in which the monitor will process the request for 
service by that task, relative to other tasks requesting 
service. 

Process 

A set of related procedures and data that are executed 
and manipulated by a computer. 

Processor 

In hardware, a data processor. In software, a computer 
program that includes the compiler, assembler, trans¬ 
lator, and related functions for a specific programming 
language (for example, FORTRAN IV processor). 

Processor status word (PSW) 

A register in the PDP-11 that indicates the current pri¬ 
ority of the processor, the condition of the previous oper¬ 
ation, and other basic control items. 

Program 

A set of machine instructions or symbolic statements 
combined to perform some task. 

Program counter (PC) 

A register used by the central processor unit to record 
the addresses of the instructions to be executed. The PC 
(register 7 of the eight general registers) always con¬ 
tains the address of the next instruction to be executed, 
or the second or third word of the current instruction. 

Program development 

The process of writing, entering, translating, and debug¬ 
ging source programs. 

Programmed request 

A set of instructions (available only to programs) that is 
used to invoke a monitor service. 

Program section 

A named, contiguous unit of code (instructions or data) 
that is considered as an entity and that can be relocated 
separately without destroying the logic of the program. 

Protocol 

A formal set of conventions governing the format and 
relative timing of information exchange between two 
communicating processes. 
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PSW 

See Processor status word. 

Queue 

Any dynamic list of items; for example, items waiting to 
be scheduled or processed according to system- or user- 
assigned priorities. 

Radix 

The base of a number system; the number of digit sym¬ 
bols required by a number system. 

RAM (Random-Access Memory) 

Memory that is accessed in such a way that the next 
location from which data is to be obtained is not de¬ 
pendent on the location of the previously obtained data. 

Random access 

Access to data in which the next location from which 
data is to be obtained is not dependent on the location of 
the previously obtained data. Contrast Sequential ac¬ 
cess. 

Read-only memory (ROM) 

Memory whose contents are not alterable by computer 
instructions. 

Reai-time processing 

The computation performed while a related or controlled 
physical activity is occurring. The results of the compu¬ 
tation can be used for guiding the process. 

Record 

A collection of related items of data treated as a unit; for 
example, a line of source code or a person’s name, rank, 
and serial number. 

Recursive 

Pertaining to a repetitive process in which the result of 
each process is dependent ujion the result of the previous 
one. 

Re-entrant 

Pertaining to a program composed of a shareable seg¬ 
ment of pure code and a nonshareable segment that is 
the data area. 

Register 

See General register. 
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Relative address 

The number that specifies the difference between the 
actual address and a base address. 

Relocate 

In programming, to move a routine from one portion of 
storage to another and to adjust the necessary address 
references so that the routine, in its new location, can be 
executed. 

Resident 

Pertaining to data or instructions that are permanently 
located in main memory. 

Resource 

Any means available to users, such as computational 
power, programs, data files, storage capacity, or a combi¬ 
nation of these. 

Restart 

To resume execution of a program. 

ROM 

See Read-only memory. 

Root segment 

The segment of an overlay structure that, when loaded, 
remains resident in memory during the execution of a 
program. 

Routine 

A set of instructions arranged in proper sequence to 
cause a computer to perform a desired operation. 

Run 

A single, continuous execution of a program. 






Sector 

A physical portion of a mass storage device. 

Segment 

See Overlay segment. 

Sequential access 

A method of data access in which the next location from 
which data is to be obtained immediately follows the 
location of the previously obtained data. Contrast 
Random access. 
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Software 

The collection of programs and routines associated with 
a computer. Compilers and library routines are exam¬ 
ples. 

Software bootstrap 

A bootstrap that is activated by loading the instructions 
of the bootstrap and specifying the appropriate load and 
start address. 

Source code 

Text, usually in the form of an ASCII format file, that 
represents a program. Such a file can be processed by an 
appropriate system program. 

Source language 

The system of symbols and syntax used to describe a 
procedure that a computer can execute. 

Spooling 

The technique by which I/O with slow devices is placed 
on mass storage devices to await processing. 

Storage 

Pertaining to a device into which data can be entered, in 
which it can be held, and from which it can be retrieved 
at a later time. 

String 

A connected sequence of entities, such as a line of char¬ 
acters. 

Subprogram 

A program or a sequence of instructions that can be 
called to perform the same task (though perhaps on dif¬ 
ferent data) at different points in a program, or in dif¬ 
ferent programs. 

Subroutine 

See Subprogram. 

Subscript 

A numeric valued expression or expression element that 
is appended to a variable name to uniquely identify spe¬ 
cific elements of an array. Subscripts are enclosed in 
parentheses. There is a subscript for each dimension of 
an array. Multiple subscripts must be separated by 
commas. For example, a two-dimensional subscript 
might be (2,5). 
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Supervisory programs 

Computer programs that have the primary function of 
scheduling, allocating, and controlling system resources. 

Swapping 

The process of moving data from memory to a mass 
storage device, temporarily using the empty memory 
area for another purpose, and then restoring the original 
data to memory. 

Synchronous 

Pertaining to related events where all changes occur si¬ 
multaneously or in definite timed intervals. 


Syntax 

The structure of expressions in a language and the rules 
governing the structure of a language. 

System program 

A program that performs system-level functions. A pro¬ 
gram that is part of the basic operating system (for ex¬ 
ample, a system utility program) is a system program. 

System voiume 

The volume on which the operating system is stored. 

Table 

A collection of data in a well-defined list. 

Terminal 

An I/O device, such as an LA120 terminal, that includes 
a keyboard and a display mechanism. In PDP-11 sys¬ 
tems, a terminal is used as the primary communication 
device between a computer system and a user. 

Time sharing 

A method of allocating resources to multiple users so 
that the computer processes a number of programs con¬ 
currently. 

Toggle 

To use switches on the computer operator’s console to 
enter data into the computer memorj'. 

Translate 

To convert from one language to another. 

Trap 

A conditional jump to a known memory location per¬ 
formed automatically by hardware as a side effect of exe¬ 
cuting a processor instruction. The address location from 
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which the jump occurs is recorded. It is distinguished 
from an interrupt, which is caused by an external event. 

Truncation 

The reduction of precision by ignoring one or more of the 
least significant digits; for example, 3.141597 truncated 
to four decimal digits is 3.141. 

Turnkey 

Pertaining to a computer system sold in a ready-to-use 
state. 

Two’s complement 

A number used to represent the negative of a given 
value in many computers. This number is formed from 
the given binary value by changing all Is to Os and all 
Os to Is and then adding 1. 

Underflow 

A condition that occurs when a mathematical operation 
yields a result whose magnitude is smaller than the 
smallest amount the hardware can handle. 

User program 

An application program. 

Utility program 

Any general-purpose program included in an operating 
system to perform common functions. 

Variable 

The symbolic representation of a logical storage location 
that can contain a value that changes during a pro¬ 
cessing operation. 

Vector 

A consecutive list of associated data. 

Volume 

A mass storage medium that can be used for file-struc¬ 
tured data storage. 

Wildcard 

A valid substitute for characters in a file specification. 
Used to perform operations on multiple files. Can be as¬ 
terisks to represent entire file names or file types, or 
percent signs to represent single characters in file 
names or file t5TJes. 

Wildcard operation 

A shorthand method of referring to all files with a spe¬ 
cific characteristic in their name. 


Glo88ary-25 





Glossary 


Word 

Sixteen binary digits treated as a unit in PDP—11 com¬ 
puter memory. 

Write-enabled 

The condition of a volume that allows information to be 
written on it. 

Write-protected 

The condition of a volume that protects the volume 
against information being written on it. 
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Absolute program sections, 12-4 
Addresses 

assignment by LINK, 12-3 
Advance (A) command (EDIT), 5-9 
Application packages, 1-10 
Assembler, 11-2 
Assembler errors, 11-7 
Assembly language 
See Machine-level language 
Assembly listings, 11-8 
ASSIGN keyboard command 
assigning logical device names, 4-11 
changing the output device, 9-11, 15-5 

Background job 
creating, 15-2 
directing input to, 15-4 
editing, 15-2 
executing, 15-5 
running, 15-2 
terminating, 15-6 
Background program 
running, 15-1 
Backup copy 
files, 17-1 
system volume, B-3 
BASIC-11 

commands, 10-3 to 10-13 
command summary 
edit, 10-6 
execution, 10-11 
file maintenance, 10-13 


demonstration progrsun, 10-7 
errors, 10-9 
running, 10-1 
exiting, 10-3 
immediate mode, 10-3 
interpreter, 10-2 
language processor, 10-1 
programming language, 10-1 
BASIC-11 program 
creating, 10-4, 10-12 
editing, 10-4 
maintaining files, 10-12 
replacing, 10-13 
running, 10-8 
saving, 10-12 
using, 10-12 

BASIC-11 programming language, 1-10, 
8-3 

BASIC keyboard command, 10-2 
BATCH 
stream, 17-1 

Beginning (B) command (EDIT), 5-4 
Bit 

definition of, 11-5 
Bootstrap 

manual operations, A-1 
procedure, 2-4 

prompts and responses (table), 2-6 
pushbutton console, A-1, A-4 
relationship with computer (figure), 
2-2 

suggestions for bootstrapping, B-2 
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Bootstrap (cont.) 

switch register console, A-1, A-5 
terminal keyboard, A-3 
typing, A-3 
Breakpoints 
clearing, 14-9 
clearing all, 14-10 
setting, 14-8 
/BRIEF 

DIRECTORY option, 4-14 
BYE command 
BASIC-11, 10-3 
Byte 

definition of, 11-5 

Character insertion 
immediate mode, 5-17 
Character search (EDIT), 5-9 
Command arguments (EDIT) 
table of, 5-5 
Commands 
BASIC 

See BASIC-11 
control 

format of, 4-3 

correcting typing errors, 4-4 
EDIT 
See EDIT 
keyboard 

See Keyboard commands 
format of, 4-2 
ODT 
See ODT 
Compiler, 9-2 
Computer 

hardware configuration, 2-3 
memory, 2-1 
PDP-11 (figure), 1-3 
Console, 1-4, 3-1 
See also Terminals 
COPY keyboard command, 7-3 
/CREATE 
EDIT option, 5-2 
LIBRARY option, 13-2, 13-5 
CREF table, 11-10 
/CROSSREFERENCE 
MACRO option, 11-7 
Cross-reference (CREF) listing, 11-10 
Cross-reference (CREF) table 
See CREF table 
CTRL/B, 15-4 
CTRL/C CTRL/C 

aborting program execution, 4-14 
returning to BASIC-11 command mode, 
10-9 


terminating background job, 15-6 
terminating indirect file execution, 
16-4 

CTRL/C ESCAPE ESCAPE (EDIT), 5-6, 
5-19 

CTRL/D, 5-19 
CTRL/E, 4-7 
CTRL/F, 15-4 
CTRL/G, 5-18 
CTRL/L, 5-10 
CTRL/N, 5-18 
CTRL/0, 4-12 
CTRL/U, 4-4 
CTRL/U (EDIT), 5-3, 5-8 
CTRL/V, 5-18 
CTRL/X, 5-8 
CTRL key, 3-4 

Date 

See also Time 
displaying, 4-9 
entering, 4-8 

DATE keyboard command, 4-8 
/DEBUG 

LINK option, 14—5 
Debugging a program, 1-9 
See also ODT 
techniques, 14-2 

Decimal/octal/binary conversion, 11-6 
Delete (D) command (EDIT), 5-8 
DELETE (DEL) command 
BASIC-11, 10-5 
DELETE key 

correcting typing errors, 4-4 
editing, 5-3, 5-8 
function, 3-3 
immediate mode, 5-18 
ODT, 14-6 

DELETE keyboard command, 7-6 
Demonstration programs 
BASIC-11, 10-7 
creating, 5-19 
FORTRAN, 5-20 
library files, 13-3 
load maps, 12-8 
MACRO, 5-21 
Device assignments 
changing, 9-11 
Device handlers, 1-8 
Device names, 4-9 
Devices 

random-access, 1-5 
random-access (figure), 1-5 
Device unit, 3-5, 4—10 
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DIFFERENCES keyboard command, 6-2 
DIRECTORY keyboard command, 4-12 
Directory listings, 3-7, 4^12 
generating, 7-1 

Directory-structured volumes, B-4 
Documentation, 1-10 
hardware manuals, 1-10 
software manuals, 1-11 
source listings, 1-11 
Drive 

See Device unit 
DUMP, 1-9 

EDIT 

command arguments (table), 5-5 
commands 
summary of, 5-13 
exiting, 5-19 

EDIT commands, 5-3 to 5-13 
Editing command mode, 5-3 
Editing commands 
ESCAPE 

returning to editing command mode, 
5-19 

Editing commands, multiple 
entering, 5-8 
erasing, 5-8 

EDIT keyboard command 
creating a file, 5-2 
editing a file, 5-4 

Edit lower (EL) command (EDIT), 5-12 
Editors 
EDIT 
See EDIT 

Edit upper (EU) command (EDIT), 5-13 
Errors 

avoiding programming, 14-1 
types of 

assembler, 11-7 
clerical, 14-2 
compiler, 9-4 
logical, 14-2 
syntax, 14-2 

ESC 

See ESCAPE key 
ESCAPE command 
entering multiple commands, 5-8 
returning to editing command mode, 
5-19 

ESCAPE ESCAPE command 
activating immediate mode, 5-17 
executing editing commands, 5-3 
executing multiple editing commands, 
5-8 


ESCAPE key, 3-4, 5-3 
See also ESCAPE command and 
ESCAPE ESCAPE command 
Examples 
re-creating, 4-3 

EXECUTE keyboard command, 9-12, 
11-16 

Exit (EX) command (EDIT), 5-3 

FB monitor, 15-3 
File maintenance 
BASIC-11, 10-12 
programs, 1-9 

See also File maintenance commands 
File maintenance commands 
summary, 7-9 

File maintenance operations, 7-1 
File names, 3-7 
changing, 7-5 
Files 

backup copy, 5-12, 17-1 
closing, 5-3, 5-11 
comparing, 6-1, 6-2 
copying, 7-3 
creating, 5-2 
deleting, 7-5 
editing, 5-4 
editing (figure), 5-2 
indirect 

See Indirect command files 
paging, 5-2 
protecting, 3-7, 7-7 
removing protection from, 7-7 
renaming, 5-6, 7-4 
storing, 3-7 
transferring, 7-3 
File types, 3-7 
changing, 7-5 
File types (table), 4-13 
Foreground/background environment, 
15-1 

Foreground/background monitor 
See FB monitor 

Foreground/background program 
communication, 15-3 
/FOREGROUND/LINK option, 15-4 
Foreground job 
creating, 15-4 
directing input to, 15-4 
executing, 15-5 
linking, 15-4 

loading device handlers, 15-5 
terminating, 15-7 
unloading, 15-7 
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Foreground program 
, running, 15-1 
FORLIB.OBJ, 9-3, 12-7 
FORTRAN 
compiler, 9-2 

demonstration program, 5-20 
running, 9-1 
library modules, 9-2 
object time system (OTS), 9-2 
programming language, 1-10, 8-3 
FORTRAN/BASIC language volume, B-5 
FORTRAN demonstration program 
errors, 9-7 

FORTRAN keyboard command, 9-4 
FORTRAN language processor, 9-1 
FORTRAN program 
compiling, 9-3 
execution commands 
summary, 9-14 
linking, 9-8, 9-9, 12-7 
producing a load map, 12-7 
producing a load module, 12-7 
running, 9-11 
sectioning, 12-5 

FORTRAN programming language, 9-1 
FRUN keyboard command, 15-6 

Get (G) command (EDIT), 5-9 
Global symbols, 12-2 
Graphics display terminal 
See VTll display hardware 
GT keyboard command, 4-6 
GT OFF keyboard command, 4-7, 5-2 
GT ON keyboard command, 4-6, 5-16 

Hardware, 1-1 
computer, 1-1 
storage medium, 1-4 
terminal, 1-3 

Hardware configuration, 2-1 
computer, 2-3 
languages, 2-4 
optional devices, 2-4 
storage volume, 2-4 
system volume, 2-3 
terminal, 2-3 
Hardware manuals, 1-10 
HELP file, 17-2 

HELP keyboard command, 17-2 
High-level languages, 1-10, 8-1 
See also BASIC-11 and FORTRAN 

Immediate mode 
BASIC-11, 10-3 


Immediate mode (EDIT) 
character insertion, 5-17 
VTll display hardware, 5-16 
Immediate mode (EDIT) commands, 
5-17 to 5-19 

VTll display hardware (table), 5-17 
Indirect command files, 16-1, 17-1 
creating, 16-1 

entering monitor commands, 16-1 
executing, 16-4 
using, 16-1 

using the editor to create, 16-2 
INITIALIZE keyboard command, 4-15 
Initializing volumes, 4-15 
Input/output devices 
See Peripheral devices 
/INSERT 

LIBRARY option, 13-6 
Insert (I) command (EDIT), 5-3 
Internal symbols, 12-2 
Interpreter 
description of, 10-2 

Jobs 

background, 15-2 
foreground, 15-4 
Jump (J) command (EDIT), 5-7 

Keyboard commands, 4-1 
Keyboard layouts (figure), 3-3 
Keyboard monitor 
See KMON 

Keyboard symbols (table), 4-4 
Kill (K) command (EDIT), 5-9 
KMON, 4-1 

Language comparisons (table), 8-2 
Language processors, 1-10, 8-1 
BASIC-11, 10-1 
FORTRAN, 9-1 
MACRO, 11-2 
Languages 

See Programming languages 
Language volume 
FORTRAN/BASIC, B-5 
Librarian, 1-9 
See also Library files 
Library files 
creating, 13-2 

demonstration programs, 13-3 
macro, 13-1 
maintaining, 13-2 
maintenance commands for 
summary, 13-7 
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Library files (cont.) 

object libraries, 13-1 
LIBRARY keyboard command, 13-2, 
13-5 

Library modules, 9-2 
Library references 
resolving, 12-2 
LINE FEED key, 3-4 
ODT, 14-7 

Linking a program, 1-9 
See also LINK keyboard command and 
Link operation 

LINK keyboard command, 9-9 
linking a foreground program, 15-4 
linking a MACRO program, 11-14 
linking ODT, 14-5 
Link operations, 12-1 
address assignment, 12-3 
overlay feature, 12-6 
producing a load map, 12-7 
producing a load module, 12-7 
program relocation, 12-3 
program sections, 12-4 
resolving library references, 12-2 
resolving symbolic references, 12-2 
summary of commands, 12-11 
Link volume, B-8 
/LIST 

FORTRAN option, 9-4 
LIBRARY option, 13-6 
MACRO option, 11-7 
List (L) command (EDIT), 5-5 
LIST command 
BASIC-11, 10-5 
LISTNH command 
BASIC-11, 10-6 
LOAD keyboard command, 15-5 
Load maps 

demonstration programs, 12-8 
producing, 12-7 
Load modules 
producing, 12-7 
Logical device names 
assigning, 4-9 
special (table), 4-10 
Lowercase characters 
EDIT, 5-12 

Machine language code, 11-4 
Machine-level language, 1-10, 8-1 
See also MACRO 
/MACRO 

LIBRARY option, 13-2 
• MACRO 

assembly listing, 11-8 


demonstration program, 5-21 
errors, 11-12 
running, 11-1 

programming language, 8-3, 11-1 
MACRO assembler, 11-2 
running, 11-15 

MACRO keyboard command, 11-7 
MACRO language processor, 11-2 
Macro library files, 13-1 
MACRO programs 
assembling, 11-6 
developing, 11-1 
linking, 11-13, 11-14, 12-7 
producing a load map, 12-7 
producing a load module, 12-7 
sectioning, 12-5 

summary of execution commands, 
11-17 

Macros, 11-11 ^ 

/MAP 

LINK option, 12-7 
/MATCH 

DIFFERENCES option, 6-3 
Memory, 2-1, 11-3 
Memory image load module, 11-14 
Monitor 

description of, 1-8 
Monitor command format, 4-2 
Monitor command language 
See Keyboard commands 
Monitor program, 3-1 

NEW command 
BASIC-11, 10-12 
Next (N) command (EDIT), 5-11 
Nondirectory-structured volumes, B-4 

Object libraries, 13-1 
building, 13-2 
creating input files, 13-2 
listing, 13-6 
updating, 13-6 

Object module relocation (figure), 12-4 
Object modules, 12-1 
linking 

FORTRAN, 9-8 
MACRO, 11-13 
linking (figure), 9-9 
Object programs 
linking, 12-1 

Object time system (OTS), 9-2 
ODT, 14-3 

accessing general registers, 14-9 
clearing breakpoints, 14-9 
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ODT (cont.) 

closing the currently open location 
address, 14-7 
commands 
summary, 14-12 
continuing execution, 14-9 
executing MACRO programs, 14-7 
linking with a program, 14-5 
location addresses, 14-7 
opening addressed locations, 14-9 
- opening bytes, 14-10 
opening location addresses, 14-7 
opening sequential location addresses, 
14-7 

relocation registers, 14-7 
removing a breakpoint, 14-9 
removing all breakpoints, 14-10 
running, 14-6 

running a program with 14-8 
setting breakpoints, 14-8 
setting relocation registers, 14-7 
ODT commands, 14-6 to 14-10 
OLD command 
BASIC-11, 10-12 
On-line debugging technique 
See ODT 

Operating system 
applications packages, 1-10 
description of, 1-8 
device handlers, 1-8 
language processors, 1-10 
monitor program, 1-8 
utility programs, 1-8 
Operating system (figure), 1-9 
Optional devices, 1-6 
hardware configuration, 2-4 
Output device 
changing, 9-11, 15-5 
Overlay feature 
See Overlay segments 
Overlay segments, 12-6 

Peripheral devices, 1-6 
Peripheral devices (figure), 1-6 
Physical crevice names (table), 4-9 
/PRINTER 

DIRECTORY option, 4-14 
Printer 
enabling, 4-7 

PRINT keyboard command, 7-8 
Processor 

stopping the, B-1 
Program counter, 11-3 
Progrartimed requests, 11-11 
Programming languages, 8-1 


BASIC-11, 8-3, 10-1 
choosing, 8-1 
comparing (table), 8-2 
DIBOL, 8-3 
FORTRAN, 8-3, 9-1 
hardware configuration, 2-4 
MACRO, 8-3, 11-1 
Program relocation, 12-3 
Programs 

See also FORTRAN program, 

BASIC-11 program, and MACRO 
programs 
debugging, 14-1 
Program sections 
absolute, 12-4 
blank, 12-5 
instruction, 12-5 
named relocatable, 12-4 
/PROMPT 
LINK option, 12-6 
Prompts 
bootstrap, 2-6 
EDIT, 5-3 
monitor, 4-1 

PROTECT keyboard command, 7-7 
Pushbutton console 
using to bootstrap, A-4 
Pushbutton console (figure), A-4 

/QUERY 

DELETE option, 7-6 
Radix 

conversion table, 11-6 
Random-access devices 
See Devices 

Read (R) command (EDIT), 5-4 
Relocatable program sections, 12-4 
Relocation registers 
ODT, 14-7 
/REMOVE 

LIBRARY option, 13-7 
RENAME keyboard command, 5-6, 7-5 
Renaming files 
cassette users, B-4 
magtape users, B-4 
REPLACE command 
BASIC-11, 10-13 
Resident monitor 
See RMON 
RETURN key 

executing commands, 4-1, 4-3 
function, 3-4 
ODT, 14-7 
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RMON, 4-1 

RT-11 computer system 
description of, 1-1 

RT-11 computer system (figure), 1-2 
RT-11 operating system 
See Operating system 
RUN command 
BASIC-11, 10-8 
ODT, 14-8 

RUN keyboard command 
background job, 15-3 
RUNNH command 
BASIC-11, 10-8 

SAVE command 
BASIC-11, 10-12 
SCRATCH (SCR) command 
BASIC-11, 10-6 
SHIFT key, 3-3 

SHOW keyboard commands, 4-11 
Software 
defined, 1-7 
operating system, 1-8 
Software (figure), 1-8 
Software manuals, 1-11 
Source comparison program, 1-9 
See also Source comparison 
Source files 
comparing, 6-1 
Source listings, 1-11 
Storage medium 
definition of, 1-4 
random-access 
See Devices 
Storage volumes 
hardware configuration, 2-4 
initializing, 4-15 
loading, 2-5 
protecting files, 3-7 
using, 3-4, 3-7 
Storage volumes (figure), 3-6 
SUBSTITUTE (SUB) command 
BASIC-11, 10-4 
Switch register console 
using to bootstrap, A-5 
Switch register console (figure), A-5 
Symbolic references 
resolving, 12-2 
Symbols 
global, 12-2 
internal, 12-2 
Symbol table, 11-4, 11-10 
SYSLIB.OBJ, 9-2, 12-7 
System macro library, 11-11 
System volume, 2-2 
backing up, B-3 


hardware configuration, 2-3 
loading, 2-5 

System volume (table), 2-4 

TAB key, 3-4 
Terminal 

hardware configuration, 2-3 
Terminal (figure), 3-2 
Terminal devices (figure), 1-4 
Terminals, 1-3, 3-1 
console, 1-4 
Text buffer, 5-1 
pointer, 5-4 
Time 

See also Date 
displaying, 4-9 
entering, 4-8 

TIME keyboard comm'* .id, 4-8 
TYPE keyboard command, 7-8 

UNLOAD keyboard command, 15-7 
UNPROTECT keyboard command, 7-7 
User service routine 
See USR 
USR, 4-1 

Utility programs, 1-8 

Verify (V) command (EDIT), 5-7 
Volume directory 
file storage, 3-7 
listing, 4-12 
operations, 7-1 
Volume structures 
comparing, B-4 

Volume substitution during operations, 

B-6 

VTll display hardware 
commands, 4-6, 4-7 
enabling, 4-6 
enabling the printer, 4-7 
immediate mode, 5-16 
using, 4-5, 5-15 

VTll display hardware (figure), 4-6 

Wildcards 

using 

with DELETE keyboard command, 
7-6 

with DIRECTORY keyboard 
command, 5-12 

Word 

definition of 11-5 
Wri'e enable 
file protection, 3-7 
Write prolecL 
file protection, 3-7 
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Call 

Write 

Chicago 

312-640-5612 

8;15 A M. to 5:00 p m CT 

Digital Equipment Corporation 
Accessories & Supplies Center 

1050 East Remington Road 
Schaumburg, IL 60195 

San Francisco 

408-734-4915 

8:15 a.m. to 5:00 p m PT 

Digital Equipment Corporation 
Accessories & Supplies Center 

Alaska, Hawaii 

603-884-6660 

8:30 A M to 6:00 p m ET 

or 408-734-4915 

8:15 A M to 5:00 p m PT 

632 Caribbean Drive 
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8:30 A M to 6:00 p m ET 

Digital Equipment Corporation 
Accessories & Supplies Center 

Rest of U.S.A., 

1-800-258-1710 

P.O. Box CS2008 
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8:30 A M. to 6.00 p m. ET 
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•Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575) 

Canada 

British Columbia 
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Ottawa-Hull 
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